Backlink Pilot

インディー製品向けの自動バックリンク送信ツール。1つの設定ファイル、1つのコマンドで完結します。

セットアップ

cd ~/Downloads/backlink-pilot
cp config.example.yaml config.yaml   # edit with product details

エンジンオプション

エンジン	セットアップ	メリット
playwright (デフォルト)	npm install	拡張機能不要
bb (推奨)	npm install -g bb-browser + Chrome 拡張機能	実ブラウザ、アンチボット対策なし、Cloudflare/OAuth 問題なし

config.yaml → browser.engine: bb で設定するか、--engine bb フラグを使用します。

コマンド

node src/cli.js scout <url> --deep              # フォームフィールドを検出
node src/cli.js submit <site>                   # ディレクトリに送信
node src/cli.js submit <site> --engine bb       # 実 Chrome を使用
node src/cli.js submit https://any-site.com     # 汎用送信 (bb-browser)
node src/cli.js submit <site> --dry-run         # プレビューのみ
node src/cli.js awesome <list-key>              # awesome-list issue を生成
node src/cli.js indexnow <url>                  # 検索エンジンに ping を送信
node src/cli.js status                          # 送信状況を確認
node src/cli.js bb-update                       # bb-browser アダプタを更新

サイトアダプタと awesome-list ターゲット: adapters.md を参照

エージェントワークフロー

1. config.yaml が存在することを確認
2. 未知のサイトはまず scout する: scout <url> --deep
3. 一度に1つずつ送信 — 出力で成功/失敗を確認
4. 未知のサイトの場合: submit https://url は汎用 bb-browser アダプタを使用
5. 進捗を追跡: status
6. ペース: サイト間は 1～3 分、同一サイトの再試行は 30～60 分

重要な制約

• 同じ製品を同じサイトに複数回送信しないこと
• 一部のサイトは UTM パラメータを拒否 → クリーンな URL で送信
• Google OAuth サイトは手動での初回ログインが必要 (playwright のみ; bb-browser は対応)
• Cloudflare Turnstile = playwright の硬い壁 → --engine bb を使用するかスキップ
• トラブルシューティング: TROUBLESHOOTING.md を参照