AI 에이전트에서 xscraper 사용

MCP 서버

Streamable HTTP이고, 키는 x-api-key 헤더에 있어요. 로컬 서버만 띄우는 클라이언트는 같은 도구를 npm 패키지 xscraper-mcp에서 실행해요. 결과는 기본적으로 게시물이나 계정마다 한 줄이고, 다음 호출에 필요한 ID가 들어 있어요. 모든 필드를 받으려면 response_format: detailed를 요청해요.

x_search_tweets

X 연산자로 게시물을 검색해요. 최신순 또는 반응이 많은 순이에요.트윗 검색 6–14 token

x_search_users

이름이나 소개로 계정을 찾아요.사용자 검색 4–6 token

x_get_user

계정 하나의 프로필이에요. 최근 게시물이나 답글을 함께 받을 수 있어요.사용자 이름으로 프로필 1 token사용자 트윗 3–7 token최신 트윗 1 token

x_get_tweet

ID나 링크로 게시물 하나를 받고, 답글이나 인용 한 페이지를 함께 받아요.ID로 트윗 1 token트윗 답글 4 token인용 트윗 4 token

x_get_followers

계정의 팔로워, 또는 그 계정이 팔로우하는 계정이에요.팔로워 4 token팔로잉 4 token

x_get_user_likes

계정이 좋아요한 게시물이에요.좋아요한 트윗 4–8 token

x_get_list_tweets

X 리스트의 게시물이에요.리스트 트윗 3–7 token

x_get_trends

지금 뜨는 주제예요.트렌드 2 token

x_get_balance

이 키에 남은 token이에요.token 잔액 0 token

클라이언트 연결

키는 콘솔에서 만든 다음, 서버를 클라이언트에 추가해요.

claude mcp add --transport http xscraper \
  https://mcp.xscraper.online/mcp \
  --header "x-api-key: $XSCRAPER_API_KEY"

스킬

Agent Skills는 작업이 맞을 때 에이전트가 불러오는 안내예요. 열린 Agent Skills 형식을 따르기 때문에 Claude Code, Codex, Muse Code, Cursor, Copilot과 다른 에이전트도 쓸 수 있어요. 소스는 GitHub에 있어요.

xscraper-api

어느 도구가 어느 질문에 답하는지, X 검색 연산자, 지출 규칙, MCP가 없는 에이전트용 REST 레퍼런스예요.

x-account-research

계정이 누구인지, 무엇을 올리는지, 반응이 진짜처럼 보이는지를 출처가 있는 짧은 브리프로 정리해요.

x-topic-research

주제, 브랜드, 출시, 티커에 대해 X가 하는 말이에요. 테마, 불만, 칭찬을 링크와 함께 정리해요.

x-thread-digest

게시물과 그 답글, 인용 글을 논점과 눈에 띄는 목소리로 요약해요.

x-monitor

일정에 맞춰 계정이나 키워드를 보고, 실행마다 검색은 한 번만 해서 새 게시물만 알려요.

/plugin marketplace add ensp1re/xscraper-agent-kit
/plugin install xscraper@xscraper

Claude 앱: GitHub에서 스킬 폴더를 받아 zip으로 묶고, Settings → Capabilities → Skills에서 업로드해요.

비용과 제한

• 도구마다 가격이 적혀 있고, 결과마다 끝에 쓴 token과 남은 잔액이 있어요.
• x_get_balance 는 무료예요. 스킬은 에이전트에게 한 페이지부터 시작하라고 하고, 약 50 token보다 더 드는 작업 전에는 먼저 물어보게 해요.
• 실패한 호출은 돌려줘요. 찾을 수 없음은 빼요. 시간이 초과된 호출은 이미 요금이 나갔을 수 있어서, 에이전트는 다시 시도하기 전에 잔액을 확인해요.
• 속도 제한은 REST와 같아요. 키마다 1분에 요청 100번이에요.