여러 플랫폼의 공개 소셜 데이터를AI 에이전트용 MCP로.

한 번 연결하면 에이전트가 SocQ의 공개 소셜 데이터 API를 찾아 호출할 수 있습니다.

https://api.socq.ai/mcp
TransportStreamable HTTP

지원 클라이언트

설정 방법

에이전트에 보여 줄 API 카탈로그 범위를 선택하고, 클라이언트를 고른 뒤, 현재 SocQ 플랫폼·엔드포인트 레지스트리에서 생성된 설정을 복사하세요.

02 / 설정

API 키는 환경 변수에 두고, Codex를 SocQ의 호스팅형 Streamable HTTP 엔드포인트에 직접 연결합니다.

클라이언트

~/.codex/config.toml설정
[mcp_servers.socq]url = "https://api.socq.ai/mcp"bearer_token_env_var = "SOCQ_API_KEY"tool_timeout_sec = 45
설정 가이드 열기

에이전트가 할 수 있는 일

SocQ MCP로 에이전트는 무엇을 할 수 있나요?

자연어로 요청하세요. 에이전트가 알맞은 기능을 고르고, 입력 요건을 읽고, 수집을 제출한 뒤, 작업이 끝나면 정규화된 결과를 정리합니다.

01
YouTube Comments API기반 엔드포인트: youtube/comments
02
Twitter Search API기반 엔드포인트: x/search
03
Facebook Ad Library Search API기반 엔드포인트: facebook-ad-library/search
04
LinkedIn Jobs API기반 엔드포인트: linkedin/jobs
05
TikTok Shop Search API기반 엔드포인트: tiktok-shop/search
06
Instagram Posts API기반 엔드포인트: instagram/posts
프롬프트에서 결과까지

AI 에이전트는 SocQ MCP를 어떻게 호출하나요?

프로토콜은 MCP 클라이언트가 처리합니다. 필요한 데이터를 설명하면 에이전트가 도구를 찾거나 고르고, 수집을 제출한 뒤, 결과가 준비될 때까지 같은 작업을 계속 읽습니다.

MCP 워크플로 문서 읽기
01

데이터 요청

플랫폼, 출처, 원하는 결과를 포함해 공개 소셜 데이터 작업을 자연어로 설명합니다.

사용자 프롬프트
02

도구 찾기 또는 선택

Compact 모드에서는 기능 레지스트리를 검색합니다. Platform과 Exact 모드에서는 타입별 도구를 바로 호출할 수 있습니다.

socq_search_endpoints → socq_describe_endpoint
03

수집 제출

SocQ가 비즈니스 입력을 검증하고, 비동기 수집을 만든 뒤, 작업 식별자를 반환합니다.

socq_execute → task_id
04

결과 읽기와 정리

에이전트는 같은 작업을 이어서 진행하고, 정규화된 결과 페이지를 읽고, 요청한 형식으로 답을 제시합니다.

socq_get_task → results.items
Compact 모드의 일반적인 흐름
자연어 요청엔드포인트 찾기작업 제출task_id결과 읽기
SocQ MCP를 쓰는 이유

크로스 플랫폼 공개 소셜 데이터를 다루는 AI 에이전트를 위해 설계

MCP 연결 하나로 에이전트가 플랫폼을 넘나들며 API를 찾아 호출하고, 컨텍스트에 들어갈 도구를 제어하며, 플랫폼별 연동 없이 비동기 수집 작업을 정규화된 결과까지 이어갈 수 있습니다.

01

연결 하나로 전체 카탈로그

Compact 탐색을 사용하면 플랫폼마다 MCP 서버를 따로 설정하지 않고도 에이전트가 SocQ API 카탈로그를 검색하고 실행할 수 있습니다.

/mcp → 검색 → 상세 확인 → 실행
02

도구 컨텍스트 제어

워크플로가 예측 가능해질수록 탐색, 선택한 플랫폼, 정확한 타입별 도구 사이에서 전환할 수 있습니다.

compact | platforms≤5 | tools≤30
03

진짜 비동기 워크플로

에이전트는 원래 작업을 이어가고, 커서 기반으로 정규화된 결과를 읽고, 수집을 중복 제출하지 않고도 파일을 가져올 수 있습니다.

task_id → 상태 → results.items → next_cursor
연동 방식 선택

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

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

AI 클라이언트가 SocQ를 직접 호출하게 하세요

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

이런 경우에 적합
AI 클라이언트와 코딩 에이전트
작동 방식
자연어 + MCP 도구 호출
다음 단계
SocQ MCP 설정
MCP 설정

추천 조합 · 에이전트 가이드 계층

Agent Skill

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

Agent Skill 살펴보기
MCP FAQ

자주 묻는 질문

SocQ MCP 서버란 무엇인가요?

AI 클라이언트를 SocQ API 카탈로그에 연결하는 호스팅형 MCP 서비스입니다. 연결하면 에이전트가 기능을 찾고, 공개 소셜 데이터 수집을 제출하고, 작업 결과를 읽을 수 있습니다.

Codex, Claude, Cursor, VS Code에 SocQ를 추가하려면 어떻게 하나요?

Codex는 호스팅형 Streamable HTTP 엔드포인트에 직접 연결할 수 있습니다. Claude Desktop, Cursor, VS Code는 @socq/mcp stdio 브리지를 실행할 수 있습니다. 위에서 해당 설정을 복사하고 SOCQ_API_KEY 값을 지정한 뒤 클라이언트를 다시 연결하세요.

MCP URL 하나가 API 하나만 뜻하나요?

아니요. 기본 엔드포인트는 SocQ 전체 기능 카탈로그를 엔드포인트 ID로 찾아 실행합니다. Platform과 Exact 도구 모드에서는 선택한 기능을 타입별 도구로 노출할 수도 있습니다.

기본 연결은 왜 모든 API를 별도 도구로 노출하지 않나요?

Compact 모드는 엔드포인트가 필요할 때만 검색하고 설명합니다. 그래서 전체 카탈로그의 스키마가 모델 컨텍스트에 들어가지 않아 컨텍스트 사용량이 줄고 도구 선택이 더 예측 가능해집니다.

API 키 없이도 사용할 수 있나요?

플랫폼, 엔드포인트, 스키마 탐색은 공개되어 있습니다. 수집, 계정, 작업 결과, 파일 관련 기능에는 유효한 SocQ API 키가 필요합니다.

수집은 왜 모든 결과를 바로 반환하지 않나요?

SocQ 수집은 비동기로 처리됩니다. 제출하면 작업 ID가 반환되며 최대 30초까지 기다릴 수 있습니다. 작업이 아직 진행 중이면 에이전트는 다시 제출하지 않고 socq_get_task 도구로 이어갑니다.

MCP와 REST API는 무엇이 다른가요?

둘 다 같은 기능 정의, 비즈니스 입력, 과금 규칙, 제한, 비동기 작업 모델을 사용합니다. MCP는 탐색과 구조화된 도구 호출을 더해 주므로 AI 클라이언트가 직접 작성한 HTTP 연동 없이도 사용할 수 있습니다.

MCP 사용량은 어떻게 과금되나요?

MCP는 엔드포인트 과금을 바꾸지 않습니다. 수집은 REST와 같은 크레딧, API 키 제한, 계정 규칙을 따릅니다. 탐색 도구는 수집 작업을 제출하지 않습니다.

에이전트는 어떤 데이터에 접근할 수 있나요?

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

AI 에이전트를 여러 플랫폼의 공개 소셜 데이터에 연결하세요

API 키 만들기