Skill 설치
호환되는 코딩 에이전트에 공개 저장소의 SocQ Skill을 추가합니다.
npx skills add SocQAPI/socq-devtoolsSocQ Skill을 설치하고, API 키를 안전하게 설정한 뒤, 리서치 목표를 자연어로 설명하세요. 에이전트가 Skill에 따라 엔드포인트를 고르고, 작업을 실행하고, 결과를 페이지 단위로 읽고, 최종 분석을 정리합니다.
호환되는 코딩 에이전트에 공개 저장소의 SocQ Skill을 추가합니다.
npx skills add SocQAPI/socq-devtools키를 로컬 환경 변수에 저장해 실시간 SocQ 작업이 안전하게 인증되도록 합니다.
SOCQ_API_KEY자연어로 요청하세요. Skill이 엔드포인트 선택, 실행, 폴링, 페이지네이션, 결과 정리를 안내합니다.
이 세 X 프로필의 최근 게시물을 비교해 주세요.API 키를 공개 채팅, 저장소, 공유 문서에 붙여 넣지 마세요. 안전한 로컬 설정은 클라이언트별 가이드를 따르세요.
전체 설치 가이드 읽기MCP는 에이전트가 SocQ의 공개 소셜 데이터 도구를 직접 사용하게 해 줍니다. Skill을 더하면 엔드포인트 선택이 정확해지고, 비용을 미리 추정할 수 있으며, 비동기·페이지네이션 작업을 끝까지 처리하고, 크로스 플랫폼 리서치도 일관된 워크플로로 수행할 수 있습니다.
MCP만 사용
MCP만으로도 에이전트가 엔드포인트를 찾고, 수집 작업을 제출하고, 작업 상태를 확인하고, 결과를 읽을 수 있습니다.
엔드포인트가 정해져 있고 단순한 일회성 수집에 적합합니다.
MCP + Agent Skill
Skill은 별도의 데이터 서비스를 추가하지 않고도 SocQ 작업을 어떻게 고르고, 어떤 순서로 실행하고, 어떻게 복구할지 에이전트에게 알려 줍니다.
여러 단계로 이루어지거나 비용이 크거나 비동기·반복·크로스 플랫폼인 리서치에 적합합니다.
| 작업 | MCP만 사용 | MCP + Skill |
|---|---|---|
| 알고 있는 엔드포인트 호출 | 도구를 직접 호출하고 결과를 읽음 | 입력을 먼저 검증한 뒤 실행하고, 일관된 워크플로로 결과를 정리 |
| 리서치 목표를 API 단계로 변환 | 에이전트가 그때그때 엔드포인트와 실행 순서를 결정 | 목표를 나누고, 엔드포인트를 고르고, 단계별로 계획하는 반복 가능한 방법을 적용 |
| 대규모 비동기 수집 실행 | 비용, 작업 상태, 페이지네이션을 에이전트가 그때그때 처리 | 실행 전에 비용을 추정하고, 원래 작업을 이어서 진행하며, 요청한 모든 페이지를 읽음 |
| 크로스 플랫폼 비교 실행 | 수집과 비교 방식을 에이전트가 매번 정의 | 제한, 수집 단계, 출력 구조를 표준화해 결과를 바로 비교할 수 있게 함 |
명확하게 정해진 SocQ API 몇 개만 호출한다면 MCP로 충분합니다. 에이전트가 여러 단계, 비동기, 크로스 플랫폼 리서치를 스스로 끝까지 수행하게 하려면 Skill을 추가하세요.
SocQ MCP 살펴보기SocQ Skill은 엔드포인트 선택, 입력 검증, 비용 추정, 비동기 작업, 페이지네이션, 오류 복구를 위한 안정적인 방법을 제공하여 공개 소셜 데이터 리서치를 더 정확하고 효율적이며 재사용하기 쉽게 만듭니다.
자연어 의도를 SocQ Capability Registry의 해당 엔드포인트와 연결합니다.
작업에 URL, 사용자 이름, 해시태그, 검색어 또는 문서에 명시된 다른 입력 중 무엇이 필요한지 판단합니다.
대규모 수집을 제출하기 전에 기능을 확인하고 크레딧을 추정합니다.
다시 제출해 이중으로 결제하는 대신 원래 작업을 계속 폴링합니다.
커서 기반 페이지네이션 결과를 읽고, 워크플로에 필요하면 원본 출력 파일을 가져옵니다.
인증, 검증, 속도 제한, 크레딧, 데이터 제공 측 오류에 맞는 다음 단계로 대응합니다.
모든 예시는 비즈니스 목표에서 시작합니다. Skill이 엔드포인트를 고르고, 입력을 검증하고, 비용을 관리하고, 비동기 작업과 페이지네이션을 끝까지 처리한 뒤, 바로 쓸 수 있는 분석으로 결과를 정리합니다.
사용 엔드포인트: instagram/posts사용 엔드포인트: tiktok/search사용 엔드포인트: x/search사용 엔드포인트: youtube/search사용 엔드포인트: linkedin/profiles사용 엔드포인트: reddit/posts대상, 플랫폼, 기간, 결과 수, 원하는 출력 형태를 확인합니다.
작업을 현재 SocQ Capability Registry 항목과 맞춥니다.
대규모 작업 전에 스키마, 제약 조건, 예상 크레딧을 확인합니다.
MCP를 우선 사용하고, 제출할 때 Skill 출처 표시를 함께 전달합니다.
수집을 중복 생성하지 않고, 반환된 작업 ID로 폴링합니다.
커서 페이지네이션을 따라가고 필요하면 파일을 가져옵니다.
엔드포인트 용어 그대로가 아니라 비교 가능한 표, 요약, 근거, 구조화된 출력으로 돌려줍니다.
실행 우선순위
호스팅형 MCP → SocQ stdio 브리지 → MCP를 쓸 수 없으면 CLI 또는 REST로 폴백.
SocQ Agent Skill은 실시간 Capability Registry와 항상 일치하므로, 에이전트가 엔드포인트를 정확하게 고르고, 비동기 작업을 끝까지 처리하고, 비용을 계획하고, 일관된 방법론으로 플랫폼을 비교할 수 있습니다.
엔드포인트 선택과 입력 안내가 MCP, API 카탈로그와 같은 기능 소스를 참조합니다.
Skill ↔ Capability Registry ↔ MCP에이전트가 언제 제출하고, 언제 기다리고, 중복 작업 없이 어떻게 이어갈지 압니다.
제출 → task_id → 폴링 → 결과대규모 작업은 크레딧을 소모하기 전에 확인하고 계획할 수 있으며, 필요하면 멱등성 키로 안전하게 재시도합니다.
스키마 → 추정 → 실행서로 다른 플랫폼에서 근거를 모을 때도 수집 제한과 출력 구조를 동일하게 적용합니다.
목표 하나 → 여러 플랫폼 → 비교 가능한 출력MCP, CLI, REST는 실행 경로이고 Agent Skill은 가이드 계층입니다. 모두 하나의 API 카탈로그와 비동기 작업 모델을 공유하므로, 워크플로에 맞는 인터페이스를 고르면 됩니다.
현재 페이지 · Agent Skill
엔드포인트 선택, 비용 관리, 페이지네이션, 작업 복구 가이드를 더합니다. 먼저 MCP와 함께 사용하거나, CLI 또는 REST로 실행하세요.
권장 실행 경로
한 번 연결하면 에이전트가 자연어로 도구를 찾고, 수집 작업을 제출하고, 비동기 작업 결과까지 이어서 처리할 수 있습니다.
AI 에이전트가 SocQ 엔드포인트를 선택하고, 입력을 구성하고, 비용을 관리하고, 비동기 수집을 끝까지 처리하고, 리서치 결과를 정리하는 방법을 알려 주는 재사용 가능한 지침 모음입니다.
MCP는 에이전트가 실시간 SocQ 도구에 접근하게 해 주고, Skill은 처음부터 끝까지 리서치를 완수하는 안정적인 방법을 알려 줍니다. Skill이 있으면 에이전트가 목표를 단계로 풀어내고, 엔드포인트를 고르고, 입력을 검증하고, 비용을 추정하고, 비동기 작업과 페이지네이션을 이어가고, 크로스 플랫폼 결과를 일관된 기준으로 정리합니다. 여러 단계로 이루어지거나 오래 걸리거나 반복되는 리서치에서 즉흥적인 판단과 중복 실행을 줄이고, 더 안정적이고 완결성 있으며 비교 가능한 결과를 얻을 수 있습니다.
아니요. Skill은 별도의 데이터 서비스를 추가하거나 비공개 기능을 열어 주지 않습니다. 같은 SocQ API 카탈로그를 더 안정적으로 사용하는 방법을 에이전트에게 알려 줄 뿐입니다.
아니요. Skill은 호스팅형 또는 stdio MCP를 우선하지만, MCP를 쓸 수 없으면 SocQ CLI나 REST API를 사용하도록 에이전트를 안내할 수 있습니다.
SocQ는 크로스 플랫폼 Skill 하나를 사용합니다. 에이전트가 작업에 맞는 기능을 SocQ 전체 카탈로그에서 고릅니다.
실시간 데이터 수집에는 유효한 SocQ API 키가 필요합니다. Skill 자체에는 인증 정보를 넣거나 저장해서는 안 되며, 키는 로컬 클라이언트 환경에서 안전하게 설정하세요.
네. 에이전트가 원래 작업을 계속 폴링하고, 결과 커서를 따라가며, 워크플로에 필요하면 원본 파일을 가져오도록 안내합니다.
현재 SocQ API 카탈로그에 있는 공개 소셜 데이터 기능을 사용할 수 있습니다. 각 API 페이지에 지원하는 입력, 공개 데이터 범위, 정규화된 결과 필드가 정리되어 있습니다.