SocQ CLIをインストール
公開されている@socq/cliパッケージを追加し、ターミナルでsocqコマンドを使えるようにします。
SocQ CLIをインストールしてAPIキーを安全に保存したら、SocQのドキュメント、MCP、RESTと共通の定義でエンドポイントを実行できます。
公開されている@socq/cliパッケージを追加し、ターミナルでsocqコマンドを使えるようにします。
キーをシステムのキーリングまたは保護されたローカル設定に保存します。
YouTubeコメントのエンドポイントを実行し、正規化された結果まで処理を続けます。
CIでは、シークレットマネージャー経由でSOCQ_API_KEYを渡し、自動実行でも認証情報を保護してください。
CLIガイドを詳しく読むAPIの検索、収集の送信、既存タスクの確認、結果の出力。各コマンドは単独で動作し、ワークフローに応じてローカルのターミナル、シェルスクリプト、CIで組み合わせて使えます。
$ socq tools youtube最新のCapability Registryから、現在のYouTubeエンドポイントを確認します。
以下の6つの例は、現在のSocQエンドポイントIDと受け付け可能な入力を使用しています。どのコマンドもそのままコピーして、ワークフローに合わせて調整できます。
エンドポイント: youtube/comments公開されているYouTubeコメントを収集し、正規化された結果を待ちます。
エンドポイント: x/search検索クエリから、テーマを絞った公開Xポストのデータセットを作成します。
エンドポイント: tiktok/search公開TikTok動画を検索し、正規化されたレコードを出力します。
エンドポイント: instagram/comments既知のInstagram投稿URLから公開コメントを収集します。
エンドポイント: facebook-ad-library/searchキーワードでFacebook Ad Libraryの公開クリエイティブを検索します。
エンドポイント: linkedin/jobs公開LinkedIn求人ページを、構造化された求人フィールドに正規化します。
SocQ CLIは各収集をバックグラウンドタスクとして送信し、タスクIDを返します。--waitで現在のコマンド内で待機するか、タスクIDを保存して後から再開し、正規化された結果を読み取ったり、利用可能なファイルを取得したりできます。
プラットフォームとリソースのコマンドを実行して、バックグラウンドタスクを作成します。
CLIは、待機・再開・結果の読み取りに使う一意の参照IDを返します。
その場で--waitを使うか、後からタスクIDで同じタスクを続行します。
タスクが成功したら、正規化された結果を出力し、利用可能なファイルを確認します。
01 / 収集を送信
該当するプラットフォームとリソースのコマンドを実行します。CLIは収集をバックグラウンドタスクとして送信します。
task_id: TASK_ID送信後、CLIが一意のタスクIDを返します。
SocQ CLIは、最新のAPIカタログ、非同期タスクの制御、正規化された結果をターミナルにもたらします。ローカルでコマンドを検証したら、同じワークフローをシェルスクリプトや自動化パイプラインでそのまま使えます。プラットフォームごとに個別の収集ツールを保守する必要はありません。
プラットフォーム、エンドポイント、入力スキーマ、課金ガイダンスは最新のCapability Registryから取得されるため、固定のコマンドカタログを別途保守する必要はありません。
最新レジストリ → 最新コマンド
JSON、JSONL、CSV、テーブル形式の出力、ファイル出力、意味のある終了コードにより、同じコマンド体系をシェルスクリプトや自動化パイプラインでも確実に使えます。
JSON · JSONL · CSV · 終了コード
タスクIDを保持しておけば、タイムアウトやプロセスの中断後も再開でき、収集を再送信することなく、ページ分割された結果と利用可能なファイルまで処理を続けられます。
送信 → TASK_ID → 再開 → 結果
MCP、CLI、RESTは実行経路で、Agent Skillはガイダンス層です。いずれも同じAPIカタログと非同期タスクモデルを共有しているため、ワークフローに合ったインターフェースを選べます。
1つのコマンド体系で、APIの検索、収集の送信、非同期タスクの再開、正規化された結果のファイル出力や自動化への受け渡しまで行えます。
オプションの拡張・Agent Skill
エンドポイントの選定、コスト管理、ページネーション、タスク復旧のガイダンスを追加します。まずはMCPと組み合わせるのがおすすめですが、CLIやRESTで実行することもできます。
SocQ CLIはSocQのコマンドラインツールです。SocQ APIの検索と呼び出し、公開ソーシャルデータの収集の送信、非同期タスクの待機・再開、正規化された結果のファイル・スクリプト・自動化パイプラインへの出力に使えます。
ターミナルでの作業、シェルスクリプト、自動化パイプライン、一括収集、ファイル出力にはCLIを使ってください。AIクライアントにツールを直接検索・呼び出しさせたい場合はMCPを、長期運用のアプリケーションとの連携にはREST APIを使ってください。
はい。CLIは最新のCapability Registryから現在のプラットフォーム、エンドポイント、入力スキーマ、課金ガイダンスを読み込むため、利用できるコマンドはSocQのAPIカタログに追従します。現在の機能はsocq platforms、socq tools、socq describeで確認できます。
必ずしも必要ではありません。日常的に使う場合は、@socq/cliをグローバルにインストールしておくといつでもsocqコマンドを使えます。たまにコマンドを実行する場合や、まずAPIカタログを確認したい場合はnpx @socq/cliを使ってください。
公開されているCapability RegistryはAPIキーなしで閲覧できます。収集、アカウント情報の照会、タスクやファイルへのアクセスにはAPIキーが必要です。ローカルではsocq auth loginを使い、自動化パイプラインではシークレットマネージャー経由でSOCQ_API_KEYを渡してください。
いいえ。ローカルの待機がタイムアウトしても、サーバー側のタスクはキャンセルされません。タスクIDを保持しておき、socq task getまたはsocq task waitを再実行すれば、収集を再送信することなく同じタスクを続行できます。
SocQ CLIはテーブル、JSON、JSONL、CSVに対応しています。少量の結果はターミナルで確認し、スクリプト、スプレッドシート、データ分析で使う場合は--outputで正規化された結果をファイルに書き出してください。
SocQ CLIにはNode.js 20以降が必要で、Windows、macOS、Linuxで動作します。