AIエージェントのための公開ソーシャルデータリサーチSkill.

既存のMCP設定はそのままで、Skillを1つ追加するだけ。エージェントがより正確にエンドポイントを選び、コストを管理し、非同期・ページネーション・クロスプラットフォームのリサーチを確実に完了できるようになります。

1つのSkillでSocQのAPIカタログ全体に対応34 対応プラットフォーム279 API機能
クイックスタート

3ステップで、エージェントに完全なリサーチワークフローを

SocQ Skillをインストールし、APIキーを安全に設定して、リサーチの目標を自然言語で伝えるだけです。エージェントはSkillに従ってエンドポイントを選び、タスクを実行し、結果をページ送りで読み取り、最終的な分析を整理します。

01

Skillをインストール

公開リポジトリから、対応するコーディングエージェントにSocQ Skillを追加します。

npx skills add SocQAPI/socq-devtools
02

APIキーを設定

キーをローカルの環境変数に保存し、SocQのタスクを安全に認証できるようにします。

SOCQ_API_KEY
03

リサーチタスクを伝える

自然言語で依頼するだけです。エンドポイントの選定、実行、ポーリング、ページネーション、結果の整理はSkillがガイドします。

この3つのXアカウントの最近のポストを比較してください。

APIキーを公開チャット、リポジトリ、共有ドキュメントに貼り付けないでください。安全なローカル設定については、各クライアント向けのガイドを参照してください。

インストールガイドを読む
MCPとMCP+Skill

MCP vs MCP+Skill

MCPはエージェントにSocQの公開ソーシャルデータツールへの直接アクセスを提供します。Skillを追加すると、エンドポイントの選定精度が上がり、コストを見積もり、非同期タスクやページネーションを完了させ、一貫したワークフローでクロスプラットフォームのリサーチを実行できます。

MCPのみ

SocQのツールに直接アクセス

MCPだけでも、エージェントはエンドポイントの検索、収集タスクの送信、タスクステータスの確認、結果の読み取りができます。

  • 入力が明確な既知のAPIを呼び出す
  • シンプルな収集を送信して結果を読み取る
  • 前後のワークフローはモデルの判断に任せる

既知のエンドポイントや、単純な単発の収集に最適です。

MCP+Agent Skill

同じツールに、確かなリサーチの手順書を

Skillは、別のデータサービスを追加することなく、SocQの操作をどう選び、どの順で実行し、どう復旧するかをエージェントに教えます。

  • 曖昧な意図を適切なエンドポイントに結び付ける
  • 大規模なジョブの前にスキーマとコストを確認する
  • ポーリング、ページ送り、安全なリトライを行い、リサーチ結果を正規化する

複数ステップ、高コスト、非同期、繰り返し、クロスプラットフォームのリサーチに最適です。

タスクMCPのみMCP+Skill
既知のエンドポイントを呼び出すツールを直接呼び出して結果を読み取るまず入力を検証し、一貫したワークフローで実行と結果の整理を行う
リサーチの目標をAPIの手順に落とし込むエージェントがエンドポイントと実行順序をその都度判断する再現可能な手法で目標を分解し、エンドポイントを選び、各ステップを計画する
大規模な非同期収集を実行するコスト、タスクステータス、ページネーションをエージェントがその都度処理する実行前にコストを見積もり、元のタスクを続行して、必要なページをすべて読み取る
クロスプラットフォームで比較する収集と比較の方法をエージェントが毎回決める取得件数、収集手順、出力構造を統一し、結果をそのまま比較できるようにする

明確に定義された少数のSocQ APIを呼び出すだけなら、MCPで十分です。複数ステップ、非同期、クロスプラットフォームのリサーチをエージェントに自律的に完了させたい場合は、Skillを追加してください。

SocQ MCPを見る
Skillが教えること

リサーチの目標から完全な結果まで、エージェントを導く

SocQ Skillは、エンドポイントの選定、入力の検証、コストの見積もり、非同期タスク、ページネーション、エラーからの復旧について確かな手法を提供し、公開ソーシャルデータのリサーチをより正確・効率的で再利用しやすいものにします。

01

適切な機能を選ぶ

自然言語の意図を、SocQ Capability Registry内の該当エンドポイントに結び付けます。

02

有効な入力を組み立てる

タスクに必要なのがURL、ユーザー名、ハッシュタグ、検索クエリ、またはその他のドキュメント記載の入力かを判断します。

03

タスクのコストを管理

大規模な収集を送信する前に、機能を確認してクレジットを見積もります。

04

非同期処理を完了させる

再送信して二重に課金されることのないよう、元のタスクのポーリングを続けます。

05

ページネーションとファイルに対応

カーソルページネーションで結果を読み取り、ワークフローで必要な場合は生の出力ファイルを取得します。

06

エラーから復旧

認証、検証、レート制限、クレジット、プロバイダーのエラーに対して、適切な次のステップで対応します。

リサーチ用プロンプト

リサーチの目標を伝えれば、ワークフローはSkillが計画します。

どの例もビジネス上の成果から始まります。Skillがエンドポイントを選び、入力を検証し、コストを管理し、非同期タスクとページネーションを完了させて、すぐに使える分析に結果をまとめます。

01
Instagram Posts API使用API: instagram/posts
02
TikTok Search API使用API: tiktok/search
03
Twitter Search API使用API: x/search
04
YouTube Search API使用API: youtube/search
05
LinkedIn Profiles API使用API: linkedin/profiles
06
Reddit Posts API使用API: reddit/posts
仕組み

リサーチの問いから構造化された結果へ

Skillは、MCP、CLI、RESTで利用できる同じSocQの機能に、判断のレイヤーを加えます。

Skillのワークフローを詳しく読む
01

目標を理解する

対象、プラットフォーム、期間、取得件数、求める出力を特定します。

02

エンドポイントを選ぶ

タスクを現在のSocQ Capability Registryのエントリに照らし合わせます。

03

入力とコストを確認

大規模なジョブの前に、スキーマ、制約、推定クレジットを確認します。

04

収集を実行

MCPを優先し、送信時にSkillのアトリビューションマーカーを渡します。

05

タスクを続行

収集を重複して作成せず、返されたタスクIDをポーリングします。

06

必要な結果をすべて読み取る

カーソルページネーションに従い、必要に応じてファイルを取得します。

07

回答を整理

エンドポイントの専門用語をそのまま出すのではなく、比較しやすい表、要約、根拠、構造化された出力を返します。

実行の優先順位

ホスト型MCP → SocQ stdioブリッジ → MCPが使えない場合はCLIまたはRESTにフォールバック。

SocQ Agent Skillを選ぶ理由

公開ソーシャルデータのリサーチに、確かな手法をエージェントへ

SocQ Agent Skillは常に最新のCapability Registryと連動し、エージェントが正確にエンドポイントを選び、非同期タスクを完了させ、コストを計画し、一貫した手法でプラットフォームを比較できるよう支援します。

01

Capability Registryと連動

エンドポイントの選定と入力のガイダンスは、MCPやAPIカタログと同じ機能定義を参照しています。

Skill ↔ Capability Registry ↔ MCP
02

非同期ワークフローにネイティブ対応

エージェントは、いつ送信し、いつ待機し、どう続行すれば作業を重複させずに済むかを理解しています。

送信 → task_id → ポーリング → 結果
03

コストを意識した実行

大規模なタスクはクレジットを消費する前に確認・計画でき、必要に応じて冪等なリトライも行えます。

スキーマ → 見積もり → 実行
04

クロスプラットフォームリサーチの規律

異なるプラットフォームから根拠を集める際も、収集件数と出力構造を統一します。

1つの目標 → 複数のプラットフォーム → 比較可能な出力
連携方法を選ぶ

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

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

現在のページ · Agent Skill

データリサーチの確かな手法をエージェントに

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

おすすめの用途
複数ステップ・非同期・クロスプラットフォームのリサーチ
仕組み
Agent Skill+MCP(推奨)
次のステップ
SocQ Agent Skillをインストール
Agent Skillを見る

推奨の実行経路

MCP

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

MCPを設定
Agent Skillに関するFAQ

よくある質問

SocQ Agent Skillとは何ですか?

SocQのエンドポイントの選び方、入力の組み立て方、コスト管理、非同期収集の完了、リサーチ結果の整理方法をAIエージェントに教える、再利用可能な指示セットです。

MCPがすでに使えるのに、なぜSkillをインストールするのですか?

MCPはエージェントにSocQのツールへのアクセスを提供し、Skillはリサーチを最初から最後まで完了させるための確かな手法を提供します。Skillがあれば、エージェントは目標を手順に落とし込み、エンドポイントを選び、入力を検証し、コストを見積もり、非同期タスクとページネーションを続行し、一貫した基準でクロスプラットフォームの結果を整理します。複数ステップ、長時間、繰り返し行うリサーチでは、場当たり的な判断や重複実行が減り、より信頼性が高く、網羅的で比較しやすい結果が得られます。

Skillを使うと、MCPより多くのAPIが使えるようになりますか?

いいえ。Skillは別のデータサービスを追加したり、非公開の機能を解放したりするものではありません。同じSocQのAPIカタログをより確実に使う方法をエージェントに教えるものです。

Skillを使うにはMCPのインストールが必要ですか?

いいえ。Skillはホスト型またはstdioのMCPを優先しますが、MCPが使えない場合はSocQ CLIやREST APIを使うようエージェントを導けます。

SocQのSkillは1つですか?それともプラットフォームごとに分かれていますか?

SocQはクロスプラットフォーム対応の1つのSkillを使用します。エージェントはタスクに応じて、SocQのカタログ全体から適切な機能を選びます。

SkillにはAPIキーが必要ですか?

実データの収集には有効なSocQのAPIキーが必要です。Skill自体には認証情報を含めたり保存したりしないでください。キーはローカルのクライアント環境で安全に設定してください。

Skillは非同期タスクとページネーションに対応していますか?

はい。元のタスクのポーリングを続け、結果のカーソルをたどり、ワークフローで必要な場合は生のファイルを取得するようエージェントを導きます。

Skillはどのようなデータにアクセスできますか?

SocQのAPIカタログで現在提供されている公開ソーシャルデータの機能を利用できます。各APIページに、対応する入力、公開データの範囲、正規化された結果フィールドが記載されています。

公開ソーシャルデータのリサーチを、エージェントにもっとスマートに

APIキーを作成