Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
从终端发现、运行、等待和导出 SocQ 任务。
npm install -g @socq/cli
socq auth login
SOCQ_API_KEY 而不是使用交互式登录。在正常终端使用中避免使用 --api-key，因为命令参数可能保留在 shell 历史记录或进程列表中。
socq platforms
socq tools youtube
socq describe youtube/comments
describe，查看能力目录中最新的输入参数和计费信息。
socq youtube comments \
--urls "https://www.youtube.com/watch?v=VIDEO_ID" \
--sort-by newest \
--wait
REST: POST /v1/youtube/comments
Endpoint: youtube/comments
MCP tool: socq_youtube_comments
CLI: socq youtube comments
socq run youtube comments \
--input-file request.json \
--format jsonl \
--output results.jsonl \
--wait
socq task get TASK_ID
socq task wait TASK_ID --timeout 180
socq task results TASK_ID --result-fields id,url,text,author.username --format csv --output results.csv
socq task files TASK_ID
--result-fields 获取更小的字段投影。
不要因为本地等待超时就重新提交采集请求，请继续查询现有任务。
request_source="cli"。当 Agent Skill 改用 CLI 执行时，请在提交命令中加入来源标记：
socq youtube comments --urls "https://www.youtube.com/watch?v=VIDEO_ID" --request-source skill
SOCQ_REQUEST_SOURCE=skill 也有相同效果。新任务会记录为 skill-cli；轮询任务时不需要添加此标记。
| 格式 | 适用场景 |
|---|---|
table | 在终端中查看少量结果 |
json | 结构化输出和脚本 |
jsonl | 流式处理或大量导出 |
csv | 电子表格和数据分析 |