開発者と自動化ワークフローのためのクロスプラットフォーム公開ソーシャルデータCLI.

1つのコマンドラインで複数の公開ソーシャルプラットフォームを扱えます。最新のAPIカタログを検索し、収集を送信し、非同期タスクを完了させて、正規化された結果をシェルスクリプト、CI、データ分析ワークフローに渡せます。

Node.js 20+最新のCapability Registry34 プラットフォーム279 APIエンドポイント
クイックスタート

3ステップで最初の公開ソーシャルデータ収集を

SocQ CLIをインストールしてAPIキーを安全に保存したら、SocQのドキュメント、MCP、RESTと共通の定義でエンドポイントを実行できます。

01

SocQ CLIをインストール

公開されている@socq/cliパッケージを追加し、ターミナルでsocqコマンドを使えるようにします。

02

APIキーを設定

キーをシステムのキーリングまたは保護されたローカル設定に保存します。

03

最初のタスクを送信

YouTubeコメントのエンドポイントを実行し、正規化された結果まで処理を続けます。

CIでは、シークレットマネージャー経由でSOCQ_API_KEYを渡し、自動実行でも認証情報を保護してください。

CLIガイドを詳しく読む
SocQ CLIでできること

タスクに必要なCLIコマンドを選ぶ

APIの検索、収集の送信、既存タスクの確認、結果の出力。各コマンドは単独で動作し、ワークフローに応じてローカルのターミナル、シェルスクリプト、CIで組み合わせて使えます。

単独で使えるコマンドの例
$ socq tools youtube

最新のCapability Registryから、現在のYouTubeエンドポイントを確認します。

実際のコマンド例

コマンドをコピーして、公開ソーシャルデータの収集を始めましょう

以下の6つの例は、現在のSocQエンドポイントIDと受け付け可能な入力を使用しています。どのコマンドもそのままコピーして、ワークフローに合わせて調整できます。

01
YouTube Comments API
エンドポイント: youtube/comments

公開されているYouTubeコメントを収集し、正規化された結果を待ちます。

02
Twitter Search API
エンドポイント: x/search

検索クエリから、テーマを絞った公開Xポストのデータセットを作成します。

03
TikTok Search API
エンドポイント: tiktok/search

公開TikTok動画を検索し、正規化されたレコードを出力します。

04
Instagram Comments API
エンドポイント: instagram/comments

既知のInstagram投稿URLから公開コメントを収集します。

05
Facebook Ad Library Search API
エンドポイント: facebook-ad-library/search

キーワードでFacebook Ad Libraryの公開クリエイティブを検索します。

06
LinkedIn Jobs API
エンドポイント: linkedin/jobs

公開LinkedIn求人ページを、構造化された求人フィールドに正規化します。

CLIの仕組み

一度送信すれば、結果が揃うまで続行

SocQ CLIは各収集をバックグラウンドタスクとして送信し、タスクIDを返します。--waitで現在のコマンド内で待機するか、タスクIDを保存して後から再開し、正規化された結果を読み取ったり、利用可能なファイルを取得したりできます。

  1. 01

    収集を送信

    プラットフォームとリソースのコマンドを実行して、バックグラウンドタスクを作成します。

  2. 02

    タスクIDを受け取る

    CLIは、待機・再開・結果の読み取りに使う一意の参照IDを返します。

  3. 03

    今すぐ待つか、後で再開

    その場で--waitを使うか、後からタスクIDで同じタスクを続行します。

  4. 04

    結果の読み取りまたはファイルの取得

    タスクが成功したら、正規化された結果を出力し、利用可能なファイルを確認します。

CLIの実行フロー

01 / 収集を送信

該当するプラットフォームとリソースのコマンドを実行します。CLIは収集をバックグラウンドタスクとして送信します。

task_id: TASK_ID

送信後、CLIが一意のタスクIDを返します。

SocQ CLIを選ぶ理由

ローカルでの収集から自動化パイプラインまで、1つのコマンド体系で

SocQ CLIは、最新のAPIカタログ、非同期タスクの制御、正規化された結果をターミナルにもたらします。ローカルでコマンドを検証したら、同じワークフローをシェルスクリプトや自動化パイプラインでそのまま使えます。プラットフォームごとに個別の収集ツールを保守する必要はありません。

新しいAPI機能もすぐにコマンドで

プラットフォーム、エンドポイント、入力スキーマ、課金ガイダンスは最新のCapability Registryから取得されるため、固定のコマンドカタログを別途保守する必要はありません。

最新レジストリ → 最新コマンド

ローカル検証から自動化へ

JSON、JSONL、CSV、テーブル形式の出力、ファイル出力、意味のある終了コードにより、同じコマンド体系をシェルスクリプトや自動化パイプラインでも確実に使えます。

JSON · JSONL · CSV · 終了コード

長時間のタスクも最初からやり直さずに再開

タスクIDを保持しておけば、タイムアウトやプロセスの中断後も再開でき、収集を再送信することなく、ページ分割された結果と利用可能なファイルまで処理を続けられます。

送信 → TASK_ID → 再開 → 結果

連携方法を選ぶ

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

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

SocQをターミナルと自動化パイプラインに

1つのコマンド体系で、APIの検索、収集の送信、非同期タスクの再開、正規化された結果のファイル出力や自動化への受け渡しまで行えます。

おすすめの用途
開発者、シェルスクリプト、自動化パイプライン
仕組み
socqコマンド+構造化出力
次のステップ
SocQ CLIをインストールして実行
CLIを使う

オプションの拡張・Agent Skill

Agent Skill

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

Agent Skillを見る
CLIに関するFAQ

よくある質問

SocQ CLIとは何ですか?

SocQ CLIはSocQのコマンドラインツールです。SocQ APIの検索と呼び出し、公開ソーシャルデータの収集の送信、非同期タスクの待機・再開、正規化された結果のファイル・スクリプト・自動化パイプラインへの出力に使えます。

SocQ CLIはどのような場面で使うべきですか?

ターミナルでの作業、シェルスクリプト、自動化パイプライン、一括収集、ファイル出力にはCLIを使ってください。AIクライアントにツールを直接検索・呼び出しさせたい場合はMCPを、長期運用のアプリケーションとの連携にはREST APIを使ってください。

SocQ CLIはSocQのAPIカタログ全体に対応していますか?

はい。CLIは最新のCapability Registryから現在のプラットフォーム、エンドポイント、入力スキーマ、課金ガイダンスを読み込むため、利用できるコマンドはSocQのAPIカタログに追従します。現在の機能はsocq platforms、socq tools、socq describeで確認できます。

SocQ CLIはグローバルにインストールする必要がありますか?

必ずしも必要ではありません。日常的に使う場合は、@socq/cliをグローバルにインストールしておくといつでもsocqコマンドを使えます。たまにコマンドを実行する場合や、まずAPIカタログを確認したい場合はnpx @socq/cliを使ってください。

SocQ CLIを使うにはAPIキーが必要ですか?

公開されているCapability RegistryはAPIキーなしで閲覧できます。収集、アカウント情報の照会、タスクやファイルへのアクセスにはAPIキーが必要です。ローカルではsocq auth loginを使い、自動化パイプラインではシークレットマネージャー経由でSOCQ_API_KEYを渡してください。

待機がタイムアウトすると収集はキャンセルされますか?

いいえ。ローカルの待機がタイムアウトしても、サーバー側のタスクはキャンセルされません。タスクIDを保持しておき、socq task getまたはsocq task waitを再実行すれば、収集を再送信することなく同じタスクを続行できます。

SocQ CLIはどの出力形式に対応していますか?

SocQ CLIはテーブル、JSON、JSONL、CSVに対応しています。少量の結果はターミナルで確認し、スクリプト、スプレッドシート、データ分析で使う場合は--outputで正規化された結果をファイルに書き出してください。

SocQ CLIはどのOSとランタイムに対応していますか?

SocQ CLIにはNode.js 20以降が必要で、Windows、macOS、Linuxで動作します。

1つのコマンドで、公開ソーシャルデータの収集を始めましょう

APIキーを作成