SocQ CLI 설치
공개된 @socq/cli 패키지를 추가해 터미널에서 socq 명령을 사용할 수 있게 합니다.
공개 소셜 플랫폼 전반에서 하나의 명령줄로 실시간 API 카탈로그를 탐색하고, 수집을 제출하고, 비동기 작업을 완료하고, 정규화된 결과를 셸 스크립트, CI, 데이터 분석 워크플로에 전달하세요.
SocQ CLI를 설치하고 API 키를 안전하게 저장한 뒤, SocQ 문서·MCP·REST와 같은 정의의 엔드포인트를 실행하세요.
공개된 @socq/cli 패키지를 추가해 터미널에서 socq 명령을 사용할 수 있게 합니다.
키를 시스템 키링이나 보호된 로컬 설정에 저장합니다.
YouTube 댓글 엔드포인트를 실행하고 정규화된 결과까지 이어갑니다.
CI에서는 시크릿 매니저로 SOCQ_API_KEY 값을 전달해, 자동 실행 중에도 인증 정보가 보호되도록 하세요.
전체 CLI 가이드 읽기API를 탐색하고, 수집을 제출하고, 기존 작업을 확인하고, 결과를 내보내세요. 각 명령은 독립적으로 동작하며, 필요하면 로컬 터미널, 셸 스크립트, CI에서 조합해 사용할 수 있습니다.
$ socq tools youtube실시간 Capability Registry에서 현재 YouTube 엔드포인트를 확인합니다.
현재 SocQ 엔드포인트 ID와 허용되는 입력을 사용한 예시 6개입니다. 각 명령을 복사해 워크플로에 맞게 수정하세요.
엔드포인트: youtube/comments공개된 YouTube 댓글을 수집하고 정규화된 결과를 기다립니다.
엔드포인트: x/search검색어로 특정 주제의 공개 X 게시물 데이터셋을 만듭니다.
엔드포인트: tiktok/search공개 TikTok 동영상을 검색하고 정규화된 레코드를 내보냅니다.
엔드포인트: instagram/comments알고 있는 Instagram 게시물 URL에서 공개 댓글을 수집합니다.
엔드포인트: facebook-ad-library/search키워드로 공개 Facebook 광고 라이브러리 소재를 검색합니다.
엔드포인트: linkedin/jobs공개 LinkedIn 채용 공고 페이지를 구조화된 채용 필드로 정규화합니다.
SocQ CLI는 수집을 백그라운드 작업으로 제출하고 작업 ID를 반환합니다. 현재 명령에서 --wait 옵션으로 기다리거나 작업 ID를 저장해 나중에 이어간 뒤, 정규화된 결과를 읽거나 사용 가능한 파일을 가져오세요.
플랫폼과 리소스 명령을 실행해 백그라운드 작업을 만듭니다.
CLI가 대기, 재개, 결과 읽기에 사용하는 고유 참조값을 반환합니다.
지금은 --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 카탈로그와 비동기 작업 모델을 공유하므로, 워크플로에 맞는 인터페이스를 고르면 됩니다.
하나의 명령 체계로 API를 찾고, 수집 작업을 제출하고, 비동기 작업을 이어서 처리하고, 정규화된 결과를 파일과 자동화 도구로 내보낼 수 있습니다.
선택 확장 · Agent Skill
엔드포인트 선택, 비용 관리, 페이지네이션, 작업 복구 가이드를 더합니다. 먼저 MCP와 함께 사용하거나, CLI 또는 REST로 실행하세요.
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 명령을 다시 실행하면 수집을 다시 제출하지 않고 같은 작업을 이어갈 수 있습니다.
table, JSON, JSONL, CSV를 지원합니다. 작은 결과는 터미널에서 읽고, --output 옵션으로 정규화된 결과를 파일에 써서 스크립트, 스프레드시트, 데이터 분석에 활용하세요.
Node.js 20 이상이 필요하며 Windows, macOS, Linux에서 실행됩니다.