複数プラットフォームの公開ソーシャルデータをAIエージェント向けMCPで.
一度接続するだけで、エージェントがSocQの公開ソーシャルデータAPIを見つけて呼び出せます。
https://api.socq.ai/mcpエージェントの処理フロー
自然言語のリクエスト
“このYouTube動画の最新コメントを100件収集してください。タスクの完了を待ってから、コメント本文、投稿者、投稿日時、いいね数を返してください。”
エンドポイントを検索
socq_search_endpoints
socq_describe_endpointsocq_execute
POST /mcp
{ "endpoint": "…", "input": { … } }task_id
202 Accepted
{ "task_id": "…" }socq_get_task
GET /mcp
{ "task_id": "…" }results.items
200 OK
{ "items": [ … ],
"next_cursor": "…" }ホスト型MCPエンドポイント
https://api.socq.ai/mcpTransport: Streamable HTTP
設定方法
エージェントに公開するAPIカタログの範囲とクライアントを選び、現在のSocQプラットフォームとエンドポイントのレジストリから生成された設定をコピーしてください。
APIキーは環境変数に保存し、CodexをSocQのホスト型Streamable HTTPエンドポイントに直接接続します。
クライアント
~/.codex/config.toml設定[mcp_servers.socq]url = "https://api.socq.ai/mcp"bearer_token_env_var = "SOCQ_API_KEY"tool_timeout_sec = 45SocQ MCPでエージェントは何ができますか?
自然言語で依頼するだけです。エージェントが該当する機能を選び、入力要件を確認して収集を送信し、タスク完了後に正規化された結果を整理します。
使用API: youtube/comments使用API: x/search使用API: facebook-ad-library/search使用API: linkedin/jobs使用API: tiktok-shop/search使用API: instagram/postsAIエージェントはどのようにSocQ MCPを呼び出すのか?
プロトコルの処理はMCPクライアントが担います。必要なデータを伝えるだけで、エージェントがツールを検索または選択し、収集を送信し、結果が揃うまで同じタスクを読み続けます。
MCPワークフローのドキュメントを読むデータを依頼
プラットフォーム、取得元、求める結果を含めて、公開ソーシャルデータのタスクを自然言語で伝えます。
ユーザーのプロンプトツールを検索・選択
Compactモードでは機能レジストリを検索します。PlatformモードとExactモードでは型付きツールを直接呼び出せます。
socq_search_endpoints → socq_describe_endpoint収集を送信
SocQが業務入力を検証して非同期の収集を作成し、そのタスクIDを返します。
socq_execute → task_id結果を読み取り整理
エージェントは同じタスクを継続して正規化された結果ページを読み取り、指定の形式で回答を提示します。
socq_get_task → results.items複数プラットフォームの公開ソーシャルデータを扱うAIエージェントのために
1つのMCP接続で、エージェントは複数プラットフォームのAPIを検索・呼び出しでき、コンテキストに入るツールを制御しながら、非同期の収集タスクを正規化された結果まで続行できます。プラットフォームごとに個別に連携する必要はありません。
1つの接続でカタログ全体に
Compactモードの検索機能により、プラットフォームごとにMCPサーバーを設定しなくても、SocQのAPIカタログを検索・実行できます。
/mcp → 検索 → 詳細確認 → 実行ツールのコンテキストを制御
ワークフローが定まるにつれて、検索型、選択したプラットフォーム、ツール指定の型付きツールを切り替えられます。
compact | platforms≤5 | tools≤30本格的な非同期ワークフロー
エージェントは元のタスクを続行し、カーソルページネーションで正規化された結果を読み取り、ファイルも取得できます。収集を重複して送信することはありません。
task_id → ステータス → results.items → next_cursorワークフローをどこからSocQに接続しますか?
MCP、CLI、RESTは実行経路で、Agent Skillはガイダンス層です。いずれも同じAPIカタログと非同期タスクモデルを共有しているため、ワークフローに合ったインターフェースを選べます。
AIクライアントからSocQを直接呼び出す
一度接続すれば、エージェントが自然言語でツールを見つけ、収集を送信し、非同期タスクの結果まで処理を続けます。
- おすすめの用途
- AIクライアントとコーディングエージェント
- 仕組み
- 自然言語+MCPツール呼び出し
- 次のステップ
- SocQ MCPを設定
推奨の組み合わせ・エージェントのガイダンス層
Agent Skill
エンドポイントの選定、コスト管理、ページネーション、タスク復旧のガイダンスを追加します。まずはMCPと組み合わせるのがおすすめですが、CLIやRESTで実行することもできます。
よくある質問
SocQ MCPサーバーとは何ですか?
AIクライアントをSocQのAPIカタログに接続するホスト型MCPサービスです。接続すると、エージェントが機能を検索し、公開ソーシャルデータの収集を送信し、タスクの結果を読み取れるようになります。
Codex、Claude、Cursor、VS CodeにSocQを追加するには?
CodexはホストされたStreamable HTTPエンドポイントに直接接続できます。Claude Desktop、Cursor、VS Codeでは@socq/mcpのstdioブリッジを実行できます。上記から該当する設定をコピーし、SOCQ_API_KEYを指定してクライアントを再接続してください。
1つのMCP URLは1つのAPIにしか対応しないのですか?
いいえ。デフォルトのエンドポイントでは、SocQの機能カタログ全体をエンドポイントIDで検索・実行できます。PlatformモードやExact toolsモードでは、選択した機能を型付きツールとして公開することもできます。
デフォルトの接続で、すべてのAPIが個別のツールとして公開されないのはなぜですか?
Compactモードでは、必要になったときだけエンドポイントを検索して詳細を確認します。カタログ全体のスキーマをモデルのコンテキストに載せないため、コンテキストの使用量が減り、ツール選択も予測しやすくなります。
APIキーなしで使えますか?
プラットフォーム、エンドポイント、スキーマの検索は公開されています。収集、アカウント、タスク結果、ファイルの操作には有効なSocQのAPIキーが必要です。
収集ですぐにすべての結果が返らないのはなぜですか?
SocQの収集は非同期で行われます。送信するとタスクIDが返され、最大30秒まで待機できます。タスクがまだ実行中の場合、エージェントは再送信せずにsocq_get_taskで続行します。
MCPとREST APIの違いは何ですか?
どちらも同じ機能定義、業務入力、課金ルール、制限、非同期タスクモデルを使用します。MCPには検索機能と構造化されたツール呼び出しが加わるため、AIクライアント側でHTTP連携を手書きする必要がありません。
MCPの利用料金はどのように課金されますか?
MCPを使ってもエンドポイントの課金は変わりません。収集にはRESTと同じクレジット、APIキーの制限、アカウントのルールが適用されます。検索用ツールは収集ジョブを送信しません。
エージェントはどのようなデータにアクセスできますか?
エージェントが呼び出せるのは、SocQのAPIカタログで提供されている公開ソーシャルデータの機能のみです。各APIページに、対応する入力、公開データの範囲、正規化された結果フィールドが記載されています。