serp-keyword-research

SERP とキーワード調査

Crawlora API から、検索エンジンの結果サンプルとキーワード／トレンドのシグナルを正規化された JSON として取得します。Baidu と Yandex は地域に合わせた検索結果を提供します。 Qwant と Startpage が現在提供するのは、オートコンプリートの候補のみです。

このスキルを使う場面

• 「Google／Bing で の検索順位は？」／「…の SERP をスナップショットにして」。
• 「…のキーワード候補／オートコンプリート」（サジェストエンドポイント）。
• 「 はトレンドになっている？」／「 の地域別／期間別の関心度は？」。
• 「…の関連クエリと急上昇クエリ」（Google Trends）。
• SEO／SERP のモニタリング、キーワードの発見、またはトレンド調査。

セットアップ（一度だけ）

• Crawlora API キーを無料で取得します（月 2,000 クレジット、クレジットカード不要）。https://crawlora.net。
• ヘルパーを実行する前に、環境変数に CRAWLORA_API_KEY を設定します。
• ヘルパーは環境変数から CRAWLORA_API_KEY を読み込み、https://api.crawlora.net/api/v1 にリクエストを送信します。キーがない、または無効な場合は 401 が返されます。

仕組み

1. SERP — Google 検索では、フラットな keyword、 language、country フィールドを指定して POST /google/search を呼び出します。Bing、Brave、DuckDuckGo、Yahoo、Baidu、 Yandex では、q を指定して GET を使います。検索結果は各プロバイダー固有のサンプルです。 各検索エンジンの市場／言語設定、結果の順序、取得時刻を保持してください。また、異なる検索エンジンの順位を共通の順位指標として扱わないでください。 503 のチャレンジが発生した場合は、失敗を記録し、リクエストされた市場に合致するときに限り別の検索エンジンを使ってください。
2. 検索カテゴリ — 検索エンジンごとのニュース／動画／画像（/google/news、/bing/videos、 /duckduckgo/news、/duckduckgo/image、/duckduckgo/video、/duckduckgo/shopping、…）。
3. キーワード候補 — オートサジェスト：GET /google/suggest?q=...、/bing/suggest、 /brave/suggest、/baidu/suggest、/yandex/suggest、/qwant/suggest、および /startpage/suggest。候補はソース内の順位順で並んだクエリ案であり、 検索ボリュームの推定値でも、オーディエンスの需要を示す証拠でもありません。
4. トレンド — Google Trends の POST エンドポイント： /google/trends/explore/interest-over-time、/interest-by-region、 /related-topics、/rising-queries、/top-queries（body：{"keywords":[...]}）。 また、GET /google/trends/trending では現在注目されているトレンドを取得できます。

エンドポイント、メソッド、パラメーターの一覧は、reference/endpoints.md を参照してください。

API の呼び出し

# GET search engines + suggest:
scripts/crawlora.sh /bing/search q="web scraping api" | jq '.'
scripts/crawlora.sh /brave/search q="web scraping api" | jq '.'
scripts/crawlora.sh /duckduckgo/search q="web scraping api" | jq '.'
scripts/crawlora.sh /yahoo-search/search q="web scraping api" | jq '.'
scripts/crawlora.sh /baidu/search q="web scraping api"
scripts/crawlora.sh /yandex/search q="web scraping api"
scripts/crawlora.sh /google/suggest q="web scraping" | jq '.'
scripts/crawlora.sh /qwant/suggest q="web scraping"
scripts/crawlora.sh /startpage/suggest q="web scraping"

# POST endpoints take a JSON body (note -X POST):
scripts/crawlora.sh -X POST /google/search '{"keyword":"web scraping api","language":"en","country":"us"}' | jq '.'
scripts/crawlora.sh -X POST /google/trends/explore/interest-over-time '{"keywords":["web scraping"]}' | jq '.'

すべてのリクエストには scripts/crawlora.sh を使います。API キーがコマンドライン引数に含まれないようにできます。

エンドポイントリファレンス

このスキルが使用する検索およびサジェストの各エンドポイント（メソッド、パス、パラメーター、説明）については、reference/endpoints.md を参照してください。

使用例

• SERP スナップショット： 対象クエリに対して POST /google/search（および /bing/search）を呼び出し、 順位付きの結果タイトル／URL を記録して、時間の経過に伴う順位を追跡します。
• キーワードの拡張： シード語句 → /google/suggest → 各候補に対して POST /google/trends/explore/rising-queries を呼び出し、勢いを調べます。
• トレンドの確認： {"keywords":["electric bikes","e-bikes"]} を指定して POST /google/trends/explore/interest-over-time を呼び出し、時系列を比較します。

注意事項と制限

• クレジット／成功時のみ課金： 2xx の場合のみ課金されます。無料枠は月 2,000 クレジットです。 キーは https://crawlora.net で取得できます。
• 公開データのみ — 公開検索結果を使用し、各検索エンジンの利用規約を遵守してください。
• 検索結果リストは、インデックス全体のエクスポートではありません。Baidu／Yandex、Qwant／Startpage、 英語圏のプロバイダーでは、地域設定や結果の意味合いが異なります。サンプルは分けて保持し、普遍的な順位、トラフィック、需要を推測しないでください。
• セキュリティ： キーは CRAWLORA_API_KEY にのみ保存してください。ハードコード、クエリパラメーターへの指定、コミットは絶対にしないでください。
• 検索エンジンがチャレンジページを表示すると、検索エンドポイントが 503 を返すことがあります。 再試行するか、検索エンジンを切り替えてください（Google ↔ Bing ↔ Brave）。Google 検索にはレート制限があり、 約 1 req/s を超えると 429 が返されます。