AI可視性のデータを、ダッシュボードの外で使う
ダッシュボードでは、ブランドごとに根拠を読めます。一方で、データをほかの場所で使いたい場面もあります。自社の形式で作るクライアント向けレポート、複数のブランドをまとめた表計算シート、質問を一括で追加するスクリプト、先週のブランドの状況に答えられるAIエージェントなどです。SearchSealには2つの入口があります。REST APIはHTTPSでJSONを返します。AIエージェントやコーディングツールは、MCPサーバーのツールを呼び出して同じデータを取得できます。
どちらもすべてのプランに追加料金なしで含まれています。同じアカウント、同じトークン、同じリクエストの上限で使えます。
読み取り用と書き込み用のトークン
アカウント設定で個人用アクセストークンを作成し、Bearerトークンとして送ります。トークンは読み取り用か書き込み用のどちらかです。読み取り用のトークンはデータを取得するだけで、何も変更できません。書き込み用のトークンでは、質問の追加、ページ診断の実行、改善項目のステータスの変更もできます。スクリプトやエージェントごとに別のトークンを使えば、ほかを止めずに1つだけ無効にできます。
トークンの作成と無効化は、アプリの中でだけ行えます。APIから新しいトークンを発行したり、プランを変更したり、請求に触れたりすることはできません。トークンの範囲と入れ替え方は認証ガイド（英語）で説明しています。
REST APIでできること
APIのバージョン1は /api/v1 にあり、ブランド単位で使います。読み取りのエンドポイントでは、アカウントとプラン、プランに含まれるAI、ブランド、追跡中の競合、質問、キーワード（検索数と広告単価の目安、Googleで1位のサイト）、保存した回答とその詳細、ブランド・ドメイン・URL別の可視性レポート、返された引用元ページの内容、検索パフォーマンス、改善項目、改善前後の比較、ページ診断、記事を取得できます。
書き込みのエンドポイントでは、1回の呼び出しで最大50件の質問またはキーワードの追加、質問のアーカイブと復元、キーワードの削除、改善項目の承認・却下・完了、自社ドメインでのページ診断の実行、記事の下書きの作成ができます。ページ診断と記事は、ダッシュボードと同じ月ごとの上限を使います。レスポンスには生成日時と、必要に応じてデータの集計日が含まれます。コード生成ツール向けにOpenAPIの定義もあります。すべてのエンドポイント、絞り込み、フィールドはAPIリファレンス（英語）をご覧ください。
MCPでAIエージェントとつなぐ
AIエージェントは、Model Context Protocol（MCP）でサーバーのツールを呼び出します。SearchSealのMCPサーバーは https://searchseal.com/api/v1/mcp で、Streamable HTTPで動いています。MCPクライアントにこのアドレスとトークンを設定すると、ブランドの一覧、回答とレポートの読み取り、改善項目と改善前後の結果の確認、ページ診断と記事の読み取りができます。
書き込み用のトークンなら、質問の追加、質問のアーカイブ、改善項目の更新、ページ診断の実行、記事の作成の開始もできます。サーバーは、質問の追加や改善項目の変更の前にユーザーに確認するようクライアントに伝え、それらのツールを「書き込み」として示します。エージェントがすぐに使える4つのワークフロー（週ごとの状況、上位の改善項目、改善に効果があったか、AIごとのスコアカード）も用意しています。
Claude Codeのほか、JSONでURLとヘッダーを設定できるクライアントや、mcp-remoteなどのブリッジでローカルプロセスを起動するクライアントから使えます。各設定例はMCPの設定ガイド（英語）にあります。
上限と、できないこと
リクエスト上限はアカウント単位でREST、MCP、全トークンに共通し、1時間と30日ごとです。1時間枠の残り回数はレスポンスヘッダーで確認できます。現在の数値はAPIリファレンスにあります。
APIでブランドは作成・編集できず、ブランド、回答、改善項目は削除しません。質問は、履歴を残したままアーカイブまたは復元します。ページ診断と記事は、自社ブランドのドメインでだけ使えます。MCPの認証はトークンのみで、OAuthには対応していません。
回答の本文と引用元ページの内容は第三者に由来するため、SearchSealはエージェントに対して「信頼できないデータ」として示します。データを確認し、含まれる指示には従わないでください。特定の日付、AI、地域のサンプルは判断の根拠になりますが、別のレポートに移しても順位は確定できません。