ドキュメント

リファレンス エージェント、MCP & API

あなたのウェブサイト、REST API、または MCP から AI SEO レポートを実行します。すべてに1つのキーが必要です。

はじめての方へ。開発者向けページでは、エンドポイントの詳細に入る前にアクセスモデルを説明しています。 SEOレポートAPIの概要を読む

認証

すべてのリクエストには Bearer トークンが必要です。サインアップ後にアカウント設定で API キーを作成してください。

Header· http
Authorization: Bearer sr__live_your_api_key

例リクエスト

curl· bash
curl -X POST https://seoreport.dev/api/v1/reports \
  -H "Authorization: Bearer sr__live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "example.com"}'

REST API エンドポイント

ベース URL： https://seoreport.dev

POST/api/v1/reports
GET/api/v1/reports/:id
GET/api/v1/reports/:id/result
GET/api/v1/reports/:id/download?format=pdf|md|txt|json

例の応答

response.json· json
{
  "success": true,
  "report": {
    "jobId": "383c5318-5e81-45a8-9df8-579d10442f72",
    "stage": "snapshot_ready",
    "status": "completed",
    "targetUrl": "https://rbeckner.com",
    "isSnapshotReady": true,
    "preview": {
      "sectionKeys": ["hero_summary", "top_findings"]
    },
    "paidUnlock": {
      "unlockEligible": true,
      "unlocked": false
    }
  },
  "pollAfterMs": 0
}

エージェントを MCP URL に接続してください。