複数プラットフォームの公開ソーシャルデータをAIエージェント向けMCPで.

一度接続するだけで、エージェントがSocQの公開ソーシャルデータAPIを見つけて呼び出せます。

https://api.socq.ai/mcp
TransportStreamable HTTP

対応クライアント

設定方法

エージェントに公開するAPIカタログの範囲とクライアントを選び、現在のSocQプラットフォームとエンドポイントのレジストリから生成された設定をコピーしてください。

02 / 設定

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 = 45
セットアップガイドを開く

エージェントにできること

SocQ MCPでエージェントは何ができますか?

自然言語で依頼するだけです。エージェントが該当する機能を選び、入力要件を確認して収集を送信し、タスク完了後に正規化された結果を整理します。

01
YouTube Comments API使用API: youtube/comments
02
Twitter Search API使用API: x/search
03
Facebook Ad Library Search API使用API: facebook-ad-library/search
04
LinkedIn Jobs API使用API: linkedin/jobs
05
TikTok Shop Search API使用API: tiktok-shop/search
06
Instagram Posts API使用API: instagram/posts
プロンプトから結果まで

AIエージェントはどのようにSocQ MCPを呼び出すのか?

プロトコルの処理はMCPクライアントが担います。必要なデータを伝えるだけで、エージェントがツールを検索または選択し、収集を送信し、結果が揃うまで同じタスクを読み続けます。

MCPワークフローのドキュメントを読む
01

データを依頼

プラットフォーム、取得元、求める結果を含めて、公開ソーシャルデータのタスクを自然言語で伝えます。

ユーザーのプロンプト
02

ツールを検索・選択

Compactモードでは機能レジストリを検索します。PlatformモードとExactモードでは型付きツールを直接呼び出せます。

socq_search_endpoints → socq_describe_endpoint
03

収集を送信

SocQが業務入力を検証して非同期の収集を作成し、そのタスクIDを返します。

socq_execute → task_id
04

結果を読み取り整理

エージェントは同じタスクを継続して正規化された結果ページを読み取り、指定の形式で回答を提示します。

socq_get_task → results.items
Compactモードの典型的なトレース
自然言語のリクエストエンドポイントを検索タスクを送信task_id結果を読み取り
SocQ MCPを選ぶ理由

複数プラットフォームの公開ソーシャルデータを扱うAIエージェントのために

1つのMCP接続で、エージェントは複数プラットフォームのAPIを検索・呼び出しでき、コンテキストに入るツールを制御しながら、非同期の収集タスクを正規化された結果まで続行できます。プラットフォームごとに個別に連携する必要はありません。

01

1つの接続でカタログ全体に

Compactモードの検索機能により、プラットフォームごとにMCPサーバーを設定しなくても、SocQのAPIカタログを検索・実行できます。

/mcp → 検索 → 詳細確認 → 実行
02

ツールのコンテキストを制御

ワークフローが定まるにつれて、検索型、選択したプラットフォーム、ツール指定の型付きツールを切り替えられます。

compact | platforms≤5 | tools≤30
03

本格的な非同期ワークフロー

エージェントは元のタスクを続行し、カーソルページネーションで正規化された結果を読み取り、ファイルも取得できます。収集を重複して送信することはありません。

task_id → ステータス → results.items → next_cursor
連携方法を選ぶ

ワークフローをどこからSocQに接続しますか?

MCP、CLI、RESTは実行経路で、Agent Skillはガイダンス層です。いずれも同じAPIカタログと非同期タスクモデルを共有しているため、ワークフローに合ったインターフェースを選べます。

AIクライアントからSocQを直接呼び出す

一度接続すれば、エージェントが自然言語でツールを見つけ、収集を送信し、非同期タスクの結果まで処理を続けます。

おすすめの用途
AIクライアントとコーディングエージェント
仕組み
自然言語+MCPツール呼び出し
次のステップ
SocQ MCPを設定
MCPを設定

推奨の組み合わせ・エージェントのガイダンス層

Agent Skill

エンドポイントの選定、コスト管理、ページネーション、タスク復旧のガイダンスを追加します。まずはMCPと組み合わせるのがおすすめですが、CLIやRESTで実行することもできます。

Agent Skillを見る
MCPに関するFAQ

よくある質問

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ページに、対応する入力、公開データの範囲、正規化された結果フィールドが記載されています。

AIエージェントを複数プラットフォームの公開ソーシャルデータに接続

APIキーを作成