AIワークフローの計画
SERP API のドキュメントと連携ガイド
サーバーサイドのタスクリクエストを送信し、アカウントで認証して、HTTPステータスとタスクごとのステータスを確認します。SEOやマーケティングデータの各ファミリーで、同じ連携パターンを試せます。
対応する検索エンジン、市場、デバイスでオーガニック検索結果、広告、検索機能を収集します。構造化JSON、HTML、および
ソース固有の
調査。
認証とタスクのリクエスト
本番アカウントではHTTP Basic認証を使用します。提供されたログイン名とパスワードを使用して、サーバー上でAuthorizationヘッダーを作成してください。認証情報をブラウザーのコードや共有サンプルに含めないでください。
サポート対象の収集用POSTルートには、次の配列を送信してください
task objects. Each task contains that route’s inputs; a keyword query, page URL and product identifier are not interchangeable
ペイロード。
// Server-side example; configure your deployment and credentials.
const url = new URL("/v3/serp/google/organic/live/advanced", process.env.DATASEO_API_ORIGIN);
const auth = Buffer.from(`${process.env.DATASEO_LOGIN}:${process.env.DATASEO_PASSWORD}`).toString("base64");
const response = await fetch(url, {
method: "POST",
headers: {Authorization: `Basic ${auth}`, "Content-Type": "application/json"},
body: JSON.stringify([{"keyword": "running shoes", "location_code": 2840, "language_code": "en", "device": "desktop"}])
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();
for (const task of data.tasks ?? []) {
if (task.status_code !== 20000) throw new Error(task.status_message);
}
// Use task.result only after checking task status.Check the HTTP status first, then the top-level response and each task status_code. A successful HTTP 200 can still contain task errors; only read task.result after validating the task.
YOUR_CONFIGURED_TOOL_SERVER
レスポンスステータスを確認
キーワードの収集には、ソースと対応する市場設定が必要です。広告競合度は有料検索の指標として解釈し、月間検索ボリュームと正規化されたトレンドスコアは分けて扱ってください。
URLを検査する場合は、url入力を指定して /v3/on_page/instant_pages から始めてください。ブラウザーのレンダリングとLighthouseには別のオプションまたはルートがあり、追加設定が必要な場合があります。
公式なモデル応答には、user_promptを指定してサポート対象のllm_responsesルートを使用してください。設定済みのモデルを一覧表示し、回答を比較する際はモデル設定を保持してください。
キューに追加されたタスクのルートは、後から取得するための識別子を返します。識別子を保管し、すべての製品で同じ配信方式が使われると想定せず、選択したルートについてドキュメントに記載されたready/getの手順を確認してください。
収集日時、入力設定、ソース識別子を保持してください。欠損フィールドはnullまたは未設定のままとし、取得できない指標をゼロに変換しないでください。
対応する検索エンジン、市場、デバイス全体で、オーガニック検索結果、広告、検索機能を確認できます。使用する
ランキング追跡と競合調査のための、構造化JSON、HTML、ソース固有の収集オプション。
このウェブサイトのコードとレスポンスは説明用です。本番環境で収集を行う前に、選択したデプロイ環境でルートのスキーマ、アクセス、クォータ、データ処理、顧客向け料金を確認する必要があります。
このアプリケーションには、検証済みの公開MCPサーバーや、ここに表示されているツール用のネイティブコネクタは現在含まれていません。必要なソースとルートを確認したうえで、サーバー側のHTTP統合のみを使用してください。
規模を拡大する前に、代表的なレスポンスを検証してください。null値、項目タイプ、フィールドの単位、エラーメッセージ、および結果がアプリケーションで答える必要のある問いに合致しているかを確認します。
ログに認証情報や機密性の高いリクエスト内容を記録しないでください。本番環境の観測データを保存する前に、選択した情報源について、保存期間、ライセンス、許可される利用方法を確認してください。
「RAGに関する最近の論文」
サポート対象の商品ルートを選択し、デプロイ先のオリジンと認証情報を設定してから、大規模なワークロードをスケジュールする前にタスクを1件テストしてください。このフロントエンドは例示用のローカルデータを使用しており、実際のAPIリクエストは送信しません。