seo-backlink-submitter · diff
git:20260907.12dc2ff to git:20260907.6a746bd
49 added, 58 removed. Audit A to A.
---
name: seo-backlink-submitter
- description: 批量将网站提交到 AI 工具目录和 SEO 目录，获取反向链接。触发条件：用户说"提交网站到目录"、"SEO 外链"、"目录提交"、或"submit site to directories"。
+ description: 为网站生成目录提交计划，并在用户显式授权时通过浏览器填写单个或批量目录表单。适用于“提交网站到目录”“SEO 外链”“目录提交”或“submit site to directories”等请求。
---
# SEO Backlink Submitter
- ## 功能说明
+ 这个 Skill 使用统一的安全模型处理单目录和批量目录：默认只读取本地配置、验证输入并输出 dry-run 计划，不访问目录网站；只有命令中明确加入 `--submit` 才允许浏览器访问和点击提交。
- 批量将网站提交到 AI 工具目录和 SEO 目录，获取反向链接。自动检测目录是否接受免费提交，支持 Playwright 浏览器自动化表单填写。单目录辅助器默认只生成 dry-run 计划，只有显式传入 `--submit` 才允许访问网络和点击提交按钮。
+ ## 目标数据
- ## 数据格式（必须提供）
+ 按 [targets/README.md](targets/README.md) 创建本地 JSON：
```json
{
"name": "网站名称",
"url": "https://example.com",
"description": "网站描述",
"email": "contact@example.com",
"category": "Developer Tools",
"tags": ["AI", "Agents", "Automation"]
}
```
- ## 执行流程
+ `name`、`url`、`description`、`email` 是必需字符串；`category` 和 `tags` 可选。URL 必须是无内嵌凭据的绝对 HTTP(S) URL。
- ### Step 1：准备工作
+ ## 单目录流程
- 默认 dry-run 不需要浏览器依赖。批量检测或真实提交前，确认系统已安装 Playwright：
+ 先运行默认 dry-run；它不会导入 Playwright，也不会访问网络：
+
```bash
- pip install playwright && playwright install chromium
+ python scripts/submit_to_directory.py \
+ --directory https://directory.example/submit \
+ --target targets/example-com.json
```
- ### Step 2：批量提交
-
- 运行 `scripts/batch_submit.py`：
+ 人工核对目标和目录后，显式加入 `--submit` 才执行真实提交：
```bash
- # Navigate to the skill directory
- cd .agent/skills/seo-backlink-submitter
-
- python scripts/batch_submit.py \
- --site "https://你的网站.com" \
- --data '{"name":"网站名称","url":"https://你的网站.com","description":"描述","email":"邮箱","category":"Developer Tools"}' \
- --directories "references/directories.txt"
+ python scripts/submit_to_directory.py \
+ --directory https://directory.example/submit \
+ --target targets/example-com.json \
+ --submit
```
- ### Step 3：单目录检测
-
- 检测某个目录是否接受免费提交：
+ 兼容入口 `scripts/quick_submit.py` 接受完全相同的参数并转发到上述逻辑；它同样默认 dry-run，不含硬编码目录。
- ```bash
- python scripts/check_directory.py https://aitoolshunt.com/submit
- ```
+ ## 批量流程
- ### Step 4：单目录提交
+ 目录文本每行一个 HTTP(S) URL，空行和 `#` 注释会被忽略。可以使用 [references/directories.txt](references/directories.txt)，也可以按项目维护自己的文件。
- 使用 [targets/README.md](targets/README.md) 约定的 JSON 文件准备单目录提交。以下命令只校验输入并显示计划，不访问目录网站：
+ 默认只输出离线批量计划：
```bash
- python scripts/submit_to_directory.py \
- --directory https://aitoolshunt.com/submit \
- --target targets/your-domain-com.json
+ python scripts/batch_submit.py \
+ --target targets/example-com.json \
+ --directories references/directories.txt
```
- 人工核对 dry-run 输出后，才可显式授权一次真实提交：
+ 核对计划后，显式加入 `--submit` 才逐项打开浏览器并尝试提交：
```bash
- python scripts/submit_to_directory.py \
- --directory https://aitoolshunt.com/submit \
- --target targets/your-domain-com.json \
+ python scripts/batch_submit.py \
+ --target targets/example-com.json \
+ --directories references/directories.txt \
--submit
```
- `submit_triggered` 只表示浏览器已经点击提交控件，不代表目录方已经审核或收录。缺少 Playwright、找不到表单字段或提交控件、输入 JSON 无效时，脚本会以非零状态退出并给出错误。
+ 批量入口复用单目录入口的目标验证和真实提交函数，不会先默认联网检测再自动提交。
- ## 目录列表
+ ## 可选的只读目录检测
- 目录列表位于 `references/directories.txt`，包含以下分类：
- - AI Skills / Agent Skills Marketplaces
- - Agent Skills Directories
- - AI Tool Directories（ProductHunt、Futurepedia、FutureTools 等）
- - Developer/Tools Directories（StackShare、DevPost 等）
- - GitHub Awesome Lists
+ 需要主动检查页面是否存在表单、登录、付费或反向链接要求时，可明确运行联网检测器：
- ## 输出格式
+ ```bash
+ python scripts/check_directory.py https://directory.example/submit
+ ```
- 提交结果以 JSON 格式保存，包含：
+ 检测结果只是页面启发式判断，不会点击提交。
- | 字段 | 说明 |
- |------|------|
- | directory | 目录名称 |
- | url | 提交页面 URL |
- | status | success / failed / paid / needs_login / error |
- | timestamp | 提交时间 |
- | error | 错误原因（如有） |
+ ## 提交安全条件
- ## 注意事项
+ - 没有 `--submit` 时，单目录、批量和兼容入口都不得访问网络。
+ - 真实提交前，页面必须成功匹配并填写 `name`、`url`、`description`、`email` 四个字段；缺少任何一个都会关闭浏览器、返回错误且不查询或点击提交控件。
+ - `category` 是可选字段，未匹配不会阻止四个必需字段完整的提交。
+ - `submit_triggered` 只表示脚本点击了提交控件，不代表目录方接收、审核、发布或产生了反向链接。
+ - 登录、验证码、付费墙或不受支持的表单需要人工处理；不要绕过访问控制。
+ - 凭据和项目目标文件不得写入仓库；当前 `.gitignore` 已排除 `targets/` 下的项目数据。
- - 部分目录需要账号登录，这类目录会被标记为 `needs_login`
- - 收费目录会被标记为 `paid`，跳过提交
- - 每个目录之间添加 2-5 秒延迟，避免触发反爬
- - 定期检查目录政策变化，部分目录可能从免费变为收费
- - 建议分批次提交，每次不超过 10 个目录
+ ## 输出与退出状态
+ - dry-run 输出 `not_submitted` 和待处理目录，不写结果文件。
+ - 真实单目录成功点击时输出 `submit_triggered`。
+ - 批量真实提交逐项输出 `submit_triggered` 或 `error`；任一错误会使批量命令非零退出。
+ - 输入错误返回退出码 2；浏览器、依赖、字段或提交控件错误返回非零状态并打印明确原因。
+
## 依赖
- Python 3.8+
- - playwright（仅真实提交需要：`pip install playwright && playwright install chromium`）
- - aiohttp（`check_directory.py` 需要）
+ - Playwright 仅用于真实提交：`python3 -m pip install playwright && playwright install chromium`
+ - `aiohttp` 仅用于显式运行 `check_directory.py`