Skillをインストール
公開リポジトリから、対応するコーディングエージェントにSocQ Skillを追加します。
npx skills add SocQAPI/socq-devtools既存のMCP設定はそのままで、Skillを1つ追加するだけ。エージェントがより正確にエンドポイントを選び、コストを管理し、非同期・ページネーション・クロスプラットフォームのリサーチを確実に完了できるようになります。
SocQ Skillをインストールし、APIキーを安全に設定して、リサーチの目標を自然言語で伝えるだけです。エージェントはSkillに従ってエンドポイントを選び、タスクを実行し、結果をページ送りで読み取り、最終的な分析を整理します。
公開リポジトリから、対応するコーディングエージェントにSocQ Skillを追加します。
npx skills add SocQAPI/socq-devtoolsキーをローカルの環境変数に保存し、SocQのタスクを安全に認証できるようにします。
SOCQ_API_KEY自然言語で依頼するだけです。エンドポイントの選定、実行、ポーリング、ページネーション、結果の整理はSkillがガイドします。
この3つのXアカウントの最近のポストを比較してください。APIキーを公開チャット、リポジトリ、共有ドキュメントに貼り付けないでください。安全なローカル設定については、各クライアント向けのガイドを参照してください。
インストールガイドを読むMCPはエージェントにSocQの公開ソーシャルデータツールへの直接アクセスを提供します。Skillを追加すると、エンドポイントの選定精度が上がり、コストを見積もり、非同期タスクやページネーションを完了させ、一貫したワークフローでクロスプラットフォームのリサーチを実行できます。
MCPのみ
MCPだけでも、エージェントはエンドポイントの検索、収集タスクの送信、タスクステータスの確認、結果の読み取りができます。
既知のエンドポイントや、単純な単発の収集に最適です。
MCP+Agent Skill
Skillは、別のデータサービスを追加することなく、SocQの操作をどう選び、どの順で実行し、どう復旧するかをエージェントに教えます。
複数ステップ、高コスト、非同期、繰り返し、クロスプラットフォームのリサーチに最適です。
| タスク | MCPのみ | MCP+Skill |
|---|---|---|
| 既知のエンドポイントを呼び出す | ツールを直接呼び出して結果を読み取る | まず入力を検証し、一貫したワークフローで実行と結果の整理を行う |
| リサーチの目標をAPIの手順に落とし込む | エージェントがエンドポイントと実行順序をその都度判断する | 再現可能な手法で目標を分解し、エンドポイントを選び、各ステップを計画する |
| 大規模な非同期収集を実行する | コスト、タスクステータス、ページネーションをエージェントがその都度処理する | 実行前にコストを見積もり、元のタスクを続行して、必要なページをすべて読み取る |
| クロスプラットフォームで比較する | 収集と比較の方法をエージェントが毎回決める | 取得件数、収集手順、出力構造を統一し、結果をそのまま比較できるようにする |
明確に定義された少数のSocQ APIを呼び出すだけなら、MCPで十分です。複数ステップ、非同期、クロスプラットフォームのリサーチをエージェントに自律的に完了させたい場合は、Skillを追加してください。
SocQ MCPを見るSocQ Skillは、エンドポイントの選定、入力の検証、コストの見積もり、非同期タスク、ページネーション、エラーからの復旧について確かな手法を提供し、公開ソーシャルデータのリサーチをより正確・効率的で再利用しやすいものにします。
自然言語の意図を、SocQ Capability Registry内の該当エンドポイントに結び付けます。
タスクに必要なのがURL、ユーザー名、ハッシュタグ、検索クエリ、またはその他のドキュメント記載の入力かを判断します。
大規模な収集を送信する前に、機能を確認してクレジットを見積もります。
再送信して二重に課金されることのないよう、元のタスクのポーリングを続けます。
カーソルページネーションで結果を読み取り、ワークフローで必要な場合は生の出力ファイルを取得します。
認証、検証、レート制限、クレジット、プロバイダーのエラーに対して、適切な次のステップで対応します。
どの例もビジネス上の成果から始まります。Skillがエンドポイントを選び、入力を検証し、コストを管理し、非同期タスクとページネーションを完了させて、すぐに使える分析に結果をまとめます。
使用API: instagram/posts使用API: tiktok/search使用API: x/search使用API: youtube/search使用API: linkedin/profiles使用API: reddit/posts対象、プラットフォーム、期間、取得件数、求める出力を特定します。
タスクを現在のSocQ Capability Registryのエントリに照らし合わせます。
大規模なジョブの前に、スキーマ、制約、推定クレジットを確認します。
MCPを優先し、送信時にSkillのアトリビューションマーカーを渡します。
収集を重複して作成せず、返されたタスクIDをポーリングします。
カーソルページネーションに従い、必要に応じてファイルを取得します。
エンドポイントの専門用語をそのまま出すのではなく、比較しやすい表、要約、根拠、構造化された出力を返します。
実行の優先順位
ホスト型MCP → SocQ stdioブリッジ → MCPが使えない場合はCLIまたはRESTにフォールバック。
SocQ Agent Skillは常に最新のCapability Registryと連動し、エージェントが正確にエンドポイントを選び、非同期タスクを完了させ、コストを計画し、一貫した手法でプラットフォームを比較できるよう支援します。
エンドポイントの選定と入力のガイダンスは、MCPやAPIカタログと同じ機能定義を参照しています。
Skill ↔ Capability Registry ↔ MCPエージェントは、いつ送信し、いつ待機し、どう続行すれば作業を重複させずに済むかを理解しています。
送信 → task_id → ポーリング → 結果大規模なタスクはクレジットを消費する前に確認・計画でき、必要に応じて冪等なリトライも行えます。
スキーマ → 見積もり → 実行異なるプラットフォームから根拠を集める際も、収集件数と出力構造を統一します。
1つの目標 → 複数のプラットフォーム → 比較可能な出力MCP、CLI、RESTは実行経路で、Agent Skillはガイダンス層です。いずれも同じAPIカタログと非同期タスクモデルを共有しているため、ワークフローに合ったインターフェースを選べます。
現在のページ · Agent Skill
エンドポイントの選定、コスト管理、ページネーション、タスク復旧のガイダンスを追加します。まずはMCPと組み合わせるのがおすすめですが、CLIやRESTで実行することもできます。
推奨の実行経路
一度接続すれば、エージェントが自然言語でツールを見つけ、収集を送信し、非同期タスクの結果まで処理を続けます。
SocQのエンドポイントの選び方、入力の組み立て方、コスト管理、非同期収集の完了、リサーチ結果の整理方法をAIエージェントに教える、再利用可能な指示セットです。
MCPはエージェントにSocQのツールへのアクセスを提供し、Skillはリサーチを最初から最後まで完了させるための確かな手法を提供します。Skillがあれば、エージェントは目標を手順に落とし込み、エンドポイントを選び、入力を検証し、コストを見積もり、非同期タスクとページネーションを続行し、一貫した基準でクロスプラットフォームの結果を整理します。複数ステップ、長時間、繰り返し行うリサーチでは、場当たり的な判断や重複実行が減り、より信頼性が高く、網羅的で比較しやすい結果が得られます。
いいえ。Skillは別のデータサービスを追加したり、非公開の機能を解放したりするものではありません。同じSocQのAPIカタログをより確実に使う方法をエージェントに教えるものです。
いいえ。Skillはホスト型またはstdioのMCPを優先しますが、MCPが使えない場合はSocQ CLIやREST APIを使うようエージェントを導けます。
SocQはクロスプラットフォーム対応の1つのSkillを使用します。エージェントはタスクに応じて、SocQのカタログ全体から適切な機能を選びます。
実データの収集には有効なSocQのAPIキーが必要です。Skill自体には認証情報を含めたり保存したりしないでください。キーはローカルのクライアント環境で安全に設定してください。
はい。元のタスクのポーリングを続け、結果のカーソルをたどり、ワークフローで必要な場合は生のファイルを取得するようエージェントを導きます。
SocQのAPIカタログで現在提供されている公開ソーシャルデータの機能を利用できます。各APIページに、対応する入力、公開データの範囲、正規化された結果フィールドが記載されています。