kennyzir SEO Backlink Submitter
这个 Skill 使用统一的安全模型处理单目录和批量目录：默认只读取本地配置、验证输入并输出 dry-run 计划，不访问目录网站；只有命令中明确加入 --submit 才允许浏览器访问和点击提交。
目标数据
按 targets/README.md 创建本地 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。
单目录流程
先运行默认 dry-run；它不会导入 Playwright，也不会访问网络：
python scripts/submit_to_directory.py \
--directory https://directory.example/submit \
--target targets/example-com.json
人工核对目标和目录后，显式加入 --submit 才执行真实提交：
python scripts/submit_to_directory.py \
--directory https://directory.example/submit \
--target targets/example-com.json \
--submit
兼容入口 scripts/quick_submit.py 接受完全相同的参数并转发到上述逻辑；它同样默认 dry-run，不含硬编码目录。
批量流程
目录文本每行一个 HTTP(S) URL，空行和 # 注释会被忽略。可以使用 references/directories.txt，也可以按项目维护自己的文件。
默认只输出离线批量计划：
python scripts/batch_submit.py \
--target targets/example-com.json \
--directories references/directories.txt
核对计划后，显式加入 --submit 才逐项打开浏览器并尝试提交：
python scripts/batch_submit.py \
--target targets/example-com.json \
--directories references/directories.txt \
--submit
批量入口复用单目录入口的目标验证和真实提交函数，不会先默认联网检测再自动提交。
可选的只读目录检测
需要主动检查页面是否存在表单、登录、付费或反向链接要求时，可明确运行联网检测器：
python scripts/check_directory.py https://directory.example/submit
检测结果只是页面启发式判断，不会点击提交。
提交安全条件
- 没有
--submit时，单目录、批量和兼容入口都不得访问网络。 - 真实提交前，页面必须成功匹配并填写
name、url、description、email四个字段；缺少任何一个都会关闭浏览器、返回错误且不查询或点击提交控件。 category是可选字段，未匹配不会阻止四个必需字段完整的提交。submit_triggered只表示脚本点击了提交控件，不代表目录方接收、审核、发布或产生了反向链接。- 登录、验证码、付费墙或不受支持的表单需要人工处理；不要绕过访问控制。
- 凭据和项目目标文件不得写入仓库；当前
.gitignore已排除targets/下的项目数据。
输出与退出状态
- dry-run 输出
not_submitted和待处理目录，不写结果文件。 - 真实单目录成功点击时输出
submit_triggered。 - 批量真实提交逐项输出
submit_triggered或error；任一错误会使批量命令非零退出。 - 输入错误返回退出码 2；浏览器、依赖、字段或提交控件错误返回非零状态并打印明确原因。
依赖
- Python 3.8+
- Playwright 仅用于真实提交：
python3 -m pip install playwright && playwright install chromium aiohttp仅用于显式运行check_directory.py