AI 에이전트를 위한 공개 소셜 데이터 리서치 Skill.

지금 쓰는 MCP 설정은 그대로 두세요. Skill 하나를 더하면 에이전트가 엔드포인트를 더 정확하게 고르고, 비용을 관리하며, 비동기·페이지네이션·크로스 플랫폼 리서치를 안정적으로 끝까지 수행합니다.

Skill 하나로 SocQ API 카탈로그 전체 사용34 지원 플랫폼279 API 기능
빠른 시작

세 단계로 에이전트에 완전한 리서치 워크플로 제공

SocQ Skill을 설치하고, API 키를 안전하게 설정한 뒤, 리서치 목표를 자연어로 설명하세요. 에이전트가 Skill에 따라 엔드포인트를 고르고, 작업을 실행하고, 결과를 페이지 단위로 읽고, 최종 분석을 정리합니다.

01

Skill 설치

호환되는 코딩 에이전트에 공개 저장소의 SocQ Skill을 추가합니다.

npx skills add SocQAPI/socq-devtools
02

API 키 설정

키를 로컬 환경 변수에 저장해 실시간 SocQ 작업이 안전하게 인증되도록 합니다.

SOCQ_API_KEY
03

리서치 작업 설명

자연어로 요청하세요. Skill이 엔드포인트 선택, 실행, 폴링, 페이지네이션, 결과 정리를 안내합니다.

이 세 X 프로필의 최근 게시물을 비교해 주세요.

API 키를 공개 채팅, 저장소, 공유 문서에 붙여 넣지 마세요. 안전한 로컬 설정은 클라이언트별 가이드를 따르세요.

전체 설치 가이드 읽기
MCP와 MCP + Skill

MCP vs. MCP + Skill

MCP는 에이전트가 SocQ의 공개 소셜 데이터 도구를 직접 사용하게 해 줍니다. Skill을 더하면 엔드포인트 선택이 정확해지고, 비용을 미리 추정할 수 있으며, 비동기·페이지네이션 작업을 끝까지 처리하고, 크로스 플랫폼 리서치도 일관된 워크플로로 수행할 수 있습니다.

MCP만 사용

실시간 SocQ 도구에 바로 접근

MCP만으로도 에이전트가 엔드포인트를 찾고, 수집 작업을 제출하고, 작업 상태를 확인하고, 결과를 읽을 수 있습니다.

  • 입력이 명확한 기존 API 호출
  • 간단한 수집 제출과 결과 읽기
  • 전후 워크플로는 모델이 알아서 결정

엔드포인트가 정해져 있고 단순한 일회성 수집에 적합합니다.

MCP + Agent Skill

같은 도구에 더해지는 안정적인 리서치 방법

Skill은 별도의 데이터 서비스를 추가하지 않고도 SocQ 작업을 어떻게 고르고, 어떤 순서로 실행하고, 어떻게 복구할지 에이전트에게 알려 줍니다.

  • 모호한 의도를 알맞은 엔드포인트로 연결
  • 대규모 작업 전에 스키마와 비용 확인
  • 폴링, 페이지네이션, 안전한 재시도, 리서치 결과 정규화

여러 단계로 이루어지거나 비용이 크거나 비동기·반복·크로스 플랫폼인 리서치에 적합합니다.

작업MCP만 사용MCP + Skill
알고 있는 엔드포인트 호출도구를 직접 호출하고 결과를 읽음입력을 먼저 검증한 뒤 실행하고, 일관된 워크플로로 결과를 정리
리서치 목표를 API 단계로 변환에이전트가 그때그때 엔드포인트와 실행 순서를 결정목표를 나누고, 엔드포인트를 고르고, 단계별로 계획하는 반복 가능한 방법을 적용
대규모 비동기 수집 실행비용, 작업 상태, 페이지네이션을 에이전트가 그때그때 처리실행 전에 비용을 추정하고, 원래 작업을 이어서 진행하며, 요청한 모든 페이지를 읽음
크로스 플랫폼 비교 실행수집과 비교 방식을 에이전트가 매번 정의제한, 수집 단계, 출력 구조를 표준화해 결과를 바로 비교할 수 있게 함

명확하게 정해진 SocQ API 몇 개만 호출한다면 MCP로 충분합니다. 에이전트가 여러 단계, 비동기, 크로스 플랫폼 리서치를 스스로 끝까지 수행하게 하려면 Skill을 추가하세요.

SocQ MCP 살펴보기
Skill이 알려 주는 것

리서치 목표에서 완전한 결과까지 에이전트 안내

SocQ Skill은 엔드포인트 선택, 입력 검증, 비용 추정, 비동기 작업, 페이지네이션, 오류 복구를 위한 안정적인 방법을 제공하여 공개 소셜 데이터 리서치를 더 정확하고 효율적이며 재사용하기 쉽게 만듭니다.

01

알맞은 기능 선택

자연어 의도를 SocQ Capability Registry의 해당 엔드포인트와 연결합니다.

02

올바른 입력 구성

작업에 URL, 사용자 이름, 해시태그, 검색어 또는 문서에 명시된 다른 입력 중 무엇이 필요한지 판단합니다.

03

작업 비용 관리

대규모 수집을 제출하기 전에 기능을 확인하고 크레딧을 추정합니다.

04

비동기 작업 완료

다시 제출해 이중으로 결제하는 대신 원래 작업을 계속 폴링합니다.

05

페이지네이션과 파일 처리

커서 기반 페이지네이션 결과를 읽고, 워크플로에 필요하면 원본 출력 파일을 가져옵니다.

06

실패에서 복구

인증, 검증, 속도 제한, 크레딧, 데이터 제공 측 오류에 맞는 다음 단계로 대응합니다.

리서치 프롬프트

리서치 목표만 설명하세요. 워크플로는 Skill이 계획합니다.

모든 예시는 비즈니스 목표에서 시작합니다. Skill이 엔드포인트를 고르고, 입력을 검증하고, 비용을 관리하고, 비동기 작업과 페이지네이션을 끝까지 처리한 뒤, 바로 쓸 수 있는 분석으로 결과를 정리합니다.

01
Instagram Posts API사용 엔드포인트: instagram/posts
02
TikTok Search API사용 엔드포인트: tiktok/search
03
Twitter Search API사용 엔드포인트: x/search
04
YouTube Search API사용 엔드포인트: youtube/search
05
LinkedIn Profiles API사용 엔드포인트: linkedin/profiles
06
Reddit Posts API사용 엔드포인트: reddit/posts
작동 방식

리서치 질문에서 구조화된 결과까지

Skill은 MCP, CLI, REST에서 쓰는 것과 같은 SocQ 기능 위에 판단 계층을 더합니다.

전체 Skill 워크플로 읽기
01

목표 파악

대상, 플랫폼, 기간, 결과 수, 원하는 출력 형태를 확인합니다.

02

엔드포인트 선택

작업을 현재 SocQ Capability Registry 항목과 맞춥니다.

03

입력과 비용 확인

대규모 작업 전에 스키마, 제약 조건, 예상 크레딧을 확인합니다.

04

수집 실행

MCP를 우선 사용하고, 제출할 때 Skill 출처 표시를 함께 전달합니다.

05

작업 이어가기

수집을 중복 생성하지 않고, 반환된 작업 ID로 폴링합니다.

06

요청한 결과를 모두 읽기

커서 페이지네이션을 따라가고 필요하면 파일을 가져옵니다.

07

답변 정리

엔드포인트 용어 그대로가 아니라 비교 가능한 표, 요약, 근거, 구조화된 출력으로 돌려줍니다.

실행 우선순위

호스팅형 MCP → SocQ stdio 브리지 → MCP를 쓸 수 없으면 CLI 또는 REST로 폴백.

SocQ Agent Skill을 쓰는 이유

에이전트에 공개 소셜 데이터 리서치의 안정적인 방법 제공

SocQ Agent Skill은 실시간 Capability Registry와 항상 일치하므로, 에이전트가 엔드포인트를 정확하게 고르고, 비동기 작업을 끝까지 처리하고, 비용을 계획하고, 일관된 방법론으로 플랫폼을 비교할 수 있습니다.

01

Capability Registry와 일치

엔드포인트 선택과 입력 안내가 MCP, API 카탈로그와 같은 기능 소스를 참조합니다.

Skill ↔ Capability Registry ↔ MCP
02

비동기 워크플로 기본 지원

에이전트가 언제 제출하고, 언제 기다리고, 중복 작업 없이 어떻게 이어갈지 압니다.

제출 → task_id → 폴링 → 결과
03

비용을 고려한 실행

대규모 작업은 크레딧을 소모하기 전에 확인하고 계획할 수 있으며, 필요하면 멱등성 키로 안전하게 재시도합니다.

스키마 → 추정 → 실행
04

크로스 플랫폼 리서치 원칙

서로 다른 플랫폼에서 근거를 모을 때도 수집 제한과 출력 구조를 동일하게 적용합니다.

목표 하나 → 여러 플랫폼 → 비교 가능한 출력
연동 방식 선택

워크플로를 SocQ와 어떻게 연결할까요?

MCP, CLI, REST는 실행 경로이고 Agent Skill은 가이드 계층입니다. 모두 하나의 API 카탈로그와 비동기 작업 모델을 공유하므로, 워크플로에 맞는 인터페이스를 고르면 됩니다.

현재 페이지 · Agent Skill

에이전트에게 데이터 리서치의 안정적인 방법을 알려 주세요

엔드포인트 선택, 비용 관리, 페이지네이션, 작업 복구 가이드를 더합니다. 먼저 MCP와 함께 사용하거나, CLI 또는 REST로 실행하세요.

이런 경우에 적합
여러 단계·비동기·여러 플랫폼에 걸친 리서치
작동 방식
Agent Skill + MCP (권장)
다음 단계
SocQ Agent Skill 설치
Agent Skill 살펴보기

권장 실행 경로

MCP

한 번 연결하면 에이전트가 자연어로 도구를 찾고, 수집 작업을 제출하고, 비동기 작업 결과까지 이어서 처리할 수 있습니다.

MCP 설정
Agent Skill FAQ

자주 묻는 질문

SocQ Agent Skill이란 무엇인가요?

AI 에이전트가 SocQ 엔드포인트를 선택하고, 입력을 구성하고, 비용을 관리하고, 비동기 수집을 끝까지 처리하고, 리서치 결과를 정리하는 방법을 알려 주는 재사용 가능한 지침 모음입니다.

MCP가 이미 잘 작동하는데 Skill을 왜 설치해야 하나요?

MCP는 에이전트가 실시간 SocQ 도구에 접근하게 해 주고, Skill은 처음부터 끝까지 리서치를 완수하는 안정적인 방법을 알려 줍니다. Skill이 있으면 에이전트가 목표를 단계로 풀어내고, 엔드포인트를 고르고, 입력을 검증하고, 비용을 추정하고, 비동기 작업과 페이지네이션을 이어가고, 크로스 플랫폼 결과를 일관된 기준으로 정리합니다. 여러 단계로 이루어지거나 오래 걸리거나 반복되는 리서치에서 즉흥적인 판단과 중복 실행을 줄이고, 더 안정적이고 완결성 있으며 비교 가능한 결과를 얻을 수 있습니다.

Skill을 쓰면 MCP보다 더 많은 API를 사용할 수 있나요?

아니요. Skill은 별도의 데이터 서비스를 추가하거나 비공개 기능을 열어 주지 않습니다. 같은 SocQ API 카탈로그를 더 안정적으로 사용하는 방법을 에이전트에게 알려 줄 뿐입니다.

Skill을 쓰려면 MCP를 꼭 설치해야 하나요?

아니요. Skill은 호스팅형 또는 stdio MCP를 우선하지만, MCP를 쓸 수 없으면 SocQ CLI나 REST API를 사용하도록 에이전트를 안내할 수 있습니다.

SocQ는 Skill 하나인가요, 플랫폼마다 따로 있나요?

SocQ는 크로스 플랫폼 Skill 하나를 사용합니다. 에이전트가 작업에 맞는 기능을 SocQ 전체 카탈로그에서 고릅니다.

Skill에 API 키가 필요한가요?

실시간 데이터 수집에는 유효한 SocQ API 키가 필요합니다. Skill 자체에는 인증 정보를 넣거나 저장해서는 안 되며, 키는 로컬 클라이언트 환경에서 안전하게 설정하세요.

Skill이 비동기 작업과 페이지네이션도 처리할 수 있나요?

네. 에이전트가 원래 작업을 계속 폴링하고, 결과 커서를 따라가며, 워크플로에 필요하면 원본 파일을 가져오도록 안내합니다.

Skill은 어떤 데이터에 접근할 수 있나요?

현재 SocQ API 카탈로그에 있는 공개 소셜 데이터 기능을 사용할 수 있습니다. 각 API 페이지에 지원하는 입력, 공개 데이터 범위, 정규화된 결과 필드가 정리되어 있습니다.

에이전트가 공개 소셜 데이터를 더 잘 리서치하게 하세요

API 키 만들기