REST API + MCPサーバー
開発者とAIエージェントのための
SEOレポートAPI
REST APIでレポートを作成し、ステータスをポーリングして、チームがウェブサイトで見るのと同じ保存済みレポートオブジェクトを読み取れます。同じAPIキーでMCP対応のエージェントも接続できます。
アクセスモデル
APIアクセスはアカウント連携です。無料アカウントを作成し、APIキーを発行してスコアプレビューから開始してください。評価パスではカードは不要です。
ウェブサイトのセッション、API コール、およびエージェントセッションは、同じ保存されたレポート状態から読み取られます。
レポートを作成し、ステータスをポーリングしてから、同じオブジェクトからプレビューまたは完全な結果を読み取ります.
利用可能なエンドポイント
/api/v1/reports/previewパートナーおよび製品ローンチフローのスコアプレビューを作成します。.
/api/v1/reports新しいレポートを作成するか、既に存在するレポートを再利用します.
/api/v1/reports/:id最新のレポートステータスとセクションを取得します.
/api/v1/reports/:id/resultレポートのロック解除後に、完全な結果を読み取ります。
/api/v1/reports/:id/download?format=jsonレポートペイロードをJSONとしてエクスポートし、プログラム的統合に使用します。
コマンドライン
ターミナルからレポートを実行します。グローバルインストールは一度だけで、即座にプレビューが表示されます.
npm install -g @seoreport/clientMCPサーバー — 同じAPI、同じキー
MCP対応のクライアントを https://seoreport.dev/mcp に向け、RESTと同じBearer APIキーで認証します。接続時にレポート用ツールとアカウント用ツールが自動的に提示されるため、追加のコードなしでエージェントが監査を実行し、結果を読み取れます。
{
"mcpServers": {
"seoreport": {
"url": "https://seoreport.dev/mcp",
"headers": {
"Authorization": "Bearer sr__live_your_api_key"
}
}
}
}create_reportURLのレポートを開始し、ジョブIDを取得します。
get_report_statusレポートが完成するまでジョブをポーリングします。
get_report完成したレポートのスコアと指摘事項を読み取ります。
list_reportsアカウントのレポート一覧を取得します。
get_report_downloadJSON・Markdown・テキスト・PDFのダウンロードURLを取得します。
get_usage残りクレジットと現在の請求期間を確認します。
チェックアウト、解約、アカウント削除は直接実行されず、ブラウザ用の確認URLを返します。エージェントは開始できますが、完了できるのは人だけです。
{
"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
}