본문으로 건너뛰기
Twexapi
한국어
English简体中文日本語Español한국어FrançaisTürkçe
Esc
↑↓이동↵열기⌘J미리보기
이 페이지에서

MCP 서버

Model Context Protocol로 Claude, ChatGPT, Cursor 등 AI 에이전트를 TwexAPI에 연결합니다. TwexAPI 계정으로 로그인하거나 API 키를 사용합니다.

TwexAPI는 https://api.twexapi.io/mcp에서 Model Context Protocol 서버를 운영합니다. AI 어시스턴트와 코딩 에이전트는 이 서버로 트윗을 검색하고, 프로필, 팔로워, 답글, 스레드, 커뮤니티, 리스트, 트렌드를 읽을 수 있습니다. 모든 호출은 REST 요청과 마찬가지로 TwexAPI 크레딧을 사용합니다.

이 페이지는 API MCP 서버를 다룹니다. 에이전트가 TwexAPI 문서를 검색하게 하려면 로그인이 필요 없는 Docs MCP 서버(https://docs.twexapi.io/mcp)를 사용하세요.

빠른 시작

서버 추가

MCP 클라이언트에 원격 서버를 추가하고 URL로 https://api.twexapi.io/mcp(Streamable HTTP)를 입력합니다. 로그인으로 연결하려면 API 키와 헤더 필드는 비워 두세요.

로그인

클라이언트가 브라우저에서 twexapi.io를 엽니다. TwexAPI 계정(이메일 또는 Google)으로 로그인하고, 승인 후 돌아갈 주소를 확인한 다음, 쓰기 권한 부여 여부를 선택하고 Approve를 선택합니다.

질문하기

채팅을 시작하고 예를 들어 “TwexAPI로 미국의 트렌드 주제를 찾고 인기 트윗을 요약해 줘”라고 요청합니다.

클라이언트별 안내:

Claude.ai와 Claude Desktop

TwexAPI를 커스텀 커넥터로 추가합니다.

ChatGPT

웹 또는 데스크톱 앱에서 개발자 모드로 연결합니다.

코딩 에이전트와 에디터

Claude Code, Codex, Cursor, VS Code, OpenCode, Windsurf.

직접 클라이언트 만들기

OAuth 2.1 엔드포인트, PKCE, 스코프, 토큰 유효 기간.

인증

서버는 두 가지 자격 증명을 받습니다.

방식 용도 사용 방법
TwexAPI로 로그인(OAuth 2.1), 권장 MCP 인가를 지원하는 클라이언트: Claude.ai, Claude Desktop, Claude Code, ChatGPT, Cursor, Codex, VS Code, OpenCode 서버 URL만 추가합니다. 로그인은 클라이언트가 처리합니다.
API 키 MCP 로그인을 지원하지 않는 클라이언트, 스크립트, 에이전트 프레임워크 x-api-key: YOUR_API_KEY 또는 Authorization: Bearer YOUR_API_KEY를 보냅니다.

API 키는 TwexAPI 대시보드에서 만들거나 복사합니다. ChatGPT는 커스텀 헤더를 보낼 수 없으므로 항상 로그인을 사용합니다.

로그인으로 허용되는 범위

  • 앱이 받는 토큰은 https://api.twexapi.io/mcp에서만 동작합니다. 앱은 비밀번호나 API 키를 볼 수 없고, 계정을 변경하거나 대시보드를 읽을 수도 없습니다.
  • 호출은 API 키로 호출할 때와 똑같이 계정의 크레딧에서 차감됩니다.
  • 읽기 권한은 항상 부여됩니다. 쓰기 권한(twexapi_write로 트윗과 답글 게시)은 동의 페이지의 체크박스로 선택하며, 체크를 해제하면 읽기 전용으로 연결됩니다.
  • 액세스 토큰은 1시간 동안 유효하며 클라이언트가 자동으로 갱신합니다. 30일 동안 어떤 앱도 사용하지 않은 인가는 만료됩니다.
  • 클라이언트를 연결할 때마다 대시보드의 Authorized apps(승인된 앱)에 항목이 추가됩니다. Revoke를 선택하면 해당 앱의 접근을 즉시 차단합니다. 클라이언트에서 커넥터를 삭제해도 TwexAPI 쪽 인가는 취소되지 않습니다.

승인하기 전에

  • 계정에 크레딧이 남아 있는 활성 API 키가 있어야 합니다. 크레딧이 없으면 동의 페이지에서 먼저 충전하라고 안내합니다. 요청은 10분 동안 유효하므로 충전한 뒤 다시 Approve를 선택할 수 있습니다.
  • After you approve, you will return to(승인 후 돌아갈 주소) 줄을 확인하세요. claude.ai, chatgpt.com, 데스크톱 앱이라면 127.0.0.1로 시작하는 주소처럼 사용 중인 앱이어야 합니다.

디스커버리

MCP 클라이언트는 필요한 정보를 모두 서버에서 가져옵니다.

URL 용도
https://api.twexapi.io/.well-known/oauth-protected-resource/mcp 보호된 리소스 메타데이터: 인가 서버의 위치를 알려 줍니다.
https://api.twexapi.io/.well-known/oauth-authorization-server 인가 서버 메타데이터: 로그인, 토큰, 등록, 취소 엔드포인트.
https://api.twexapi.io/.well-known/mcp.json 레지스트리용 MCP 서버 카드. /.well-known/mcp/server-card.json에서도 같은 내용을 제공합니다.

자격 증명이 없는 요청에는 보호된 리소스 메타데이터 URL이 담긴 WWW-Authenticate: Bearer 챌린지와 함께 401이 반환됩니다. 클라이언트는 이 챌린지를 보고 로그인을 시작합니다. 전체 흐름은 MCP 클라이언트용 OAuth를 참고하세요.

도구

도구 기능 사용 가능 조건
explore 엔드포인트 카탈로그를 검색해 메서드, 경로, 파라미터, 예시, 호출할 도구를 반환합니다. 크레딧을 사용하지 않습니다. 항상
twexapi_request 검색, 프로필, 팔로워, 답글, 커뮤니티, 리스트, 트렌드 등 읽기 전용 엔드포인트를 호출합니다. 항상
twexapi_write 쓰기 엔드포인트를 호출합니다. 현재는 트윗 또는 답글 게시이며 X 계정 쿠키가 필요합니다. 쓰기 권한을 허용한 경우

Claude 같은 클라이언트는 twexapi_write를 호출할 때마다 확인을 요청합니다. 좋아요, 팔로우, DM 등 다른 쓰기 작업은 REST API에서만 사용할 수 있습니다. 입력, 출력, 전체 카탈로그는 MCP 도구 레퍼런스를 참고하세요.

크레딧과 오류

상황 표시되는 내용
자격 증명 없음 로그인 챌린지와 함께 401. 로그인을 지원하는 클라이언트는 자동으로 로그인을 시작합니다.
API 키가 잘못되었거나 로그인이 만료·취소됨 error="invalid_token"과 함께 401. 다시 로그인하거나 키를 확인하세요.
대시보드에서 API 키가 비활성화됨 403, “This TwexAPI API key is disabled.”
크레딧 소진 연결은 그대로 동작하고 explore는 무료입니다. 다른 도구 호출은 “No credits left on this TwexAPI account. Top up at https://twexapi.io/dashboard and try again.“을 반환합니다.
읽기 전용 인가 twexapi_write가 표시되지 않습니다. 게시하려면 쓰기 체크를 유지한 채 다시 연결하세요.

연결 문제를 신고할 때는 응답 헤더 X-Request-Id와 UTC 시각을 함께 알려 주세요.

계정 없이 호출별 결제

API 키 대신 Machine Payments Protocol로 결제하는 MCP 클라이언트는 https://api.twexapi.io/mcp/pay에 연결합니다. 이 엔드포인트는 익명 요청을 받고, 결제 대상 도구 호출에 결제 챌린지를 반환합니다. 기본 /mcp 엔드포인트는 항상 로그인 또는 API 키가 필요합니다.

Claude.ai와 Claude Desktop

Claude.ai와 Claude Desktop은 같은 커넥터를 공유하므로 TwexAPI는 한 번만 추가하면 됩니다.

커스텀 커넥터 추가

Settings → Connectors를 열고 Add custom connector를 선택합니다. 이름에 TwexAPI, URL에 https://api.twexapi.io/mcp를 입력합니다. OAuth 클라이언트 ID와 시크릿은 비워 두고 Add를 선택합니다.

연결

Connect를 선택하고, 열린 TwexAPI 페이지에서 로그인한 뒤 Approve를 선택합니다.

채팅에서 사용

채팅에서 + 메뉴를 열고 커넥터에서 TwexAPI를 켠 뒤 질문합니다.

Team 및 Enterprise 플랜에서는 소유자가 먼저 커스텀 커넥터를 허용해야 할 수 있습니다.

에이전트 프레임워크

에이전트 런타임과 스크립트는 보통 API 키를 보냅니다. OpenAI Agents SDK 예시:

from agents.mcp import MCPServerStreamableHttp

async with MCPServerStreamableHttp(
    params={
        "url": "https://api.twexapi.io/mcp",
        "headers": {"x-api-key": "YOUR_API_KEY"},
    },
) as twexapi:
    # use TwexAPI as a tool provider
    pass

키를 코드에 직접 쓰지 말고 환경 변수나 시크릿 저장소에서 불러오세요.

MCP와 REST API 비교

MCP 서버

AI 어시스턴트, IDE 에이전트, 자연어 워크플로에 적합합니다. 에이전트는 explore로 엔드포인트를 찾고 twexapi_request 또는 twexapi_write로 호출합니다.

REST API

백엔드 서비스, 예약 작업, 직접 통합에 적합합니다. Authorization: Bearer YOUR_API_KEY로 https://api.twexapi.io/*를 호출합니다. 모든 엔드포인트, 세밀한 페이지네이션 제어, SDK 코드가 필요하면 API 레퍼런스를 사용하세요.

에이전트가 자연어로 X/Twitter 데이터를 다루게 하려면 MCP를, 프로덕션 백엔드를 만들거나 대량의 결과를 저장하려면 REST를 사용하세요.

프롬프트 예시

연결한 뒤 AI 에이전트에게 다음과 같이 요청할 수 있습니다.

검색과 조회

  • 지난 24시간 동안 AI agents에 관한 X 게시물을 검색해서 상위 20개 트윗을 트윗 ID, 작성자, 작성 시각, 좋아요 수, 리포스트 수, 한 줄 요약과 함께 보여 줘.
  • @elonmusk의 최근 트윗 중 Grok 또는 AI를 언급한 것을 찾아 주제별로 묶고 X 링크를 붙여 줘.
  • 이 트윗을 읽어 줘: https://x.com/elonmusk/status/2104354931595423762. 내용을 요약한 뒤 가장 관련 있는 답글을 가져와 답글 ID를 보여 줘.
  • 트윗 ID 2104354931595423762의 유사 트윗을 가져오고 각각 왜 관련 있는지 설명해 줘.

프로필과 팔로우 관계

  • @openai의 프로필 소개를 읽고 사용자 이름, 표시 이름, 사용자 ID, 위치, 팔로워 수, 프로필 URL을 알려 줘.
  • AI infrastructure 관련 X 사용자를 검색해서 사용자 이름, 소개, 팔로워 수, 일치 이유와 함께 25개 계정을 보여 줘.
  • @elonmusk의 최신 팔로워를 가져와 소개에 AI, 스타트업, 암호화폐를 언급한 계정을 찾아 줘.
  • @sama의 팔로워를 커서 페이지네이션으로 한 페이지 가져와 처음 20명을 보여 주고, 다음 실행을 위해 next_cursor를 남겨 줘.

트렌드

  • 지원되는 글로벌 트렌드 국가를 모두 보여 주고 united-states의 상위 트렌드 주제를 가져와 줘.
  • united-states에서 주제 technology, 콘텐츠 태그 AI인 트렌드 트윗을 가져와 트윗 ID, 작성자, 참여 지표를 보여 줘.
  • united-states, japan, united-kingdom의 트렌드 주제를 비교해서 지역별 차이를 요약해 줘.

답글, 인용, 스레드

  • https://x.com/elonmusk/status/2104354931595423762의 답글을 가져와 관련도순으로 정렬하고 답글 ID, 작성자, 본문, 좋아요 수를 보여 줘.
  • 트윗 ID 2104354931595423762를 리트윗한 사용자 50명을 나열하고 사용자 ID, 사용자 이름, 표시 이름, 가능하면 팔로워 수를 보여 줘.
  • 트윗 ID 2104354931595423762의 인용 트윗을 가져와 지지, 비판, 중립으로 분류해 줘.
  • 트윗 ID 2104354931595423762의 전체 스레드를 추출해서 Markdown 개요로 정리해 줘.

아티클, 커뮤니티, 리스트

  • X 아티클 2104354931595423762를 Markdown으로 가져와 5개 항목의 요약 브리핑으로 정리해 줘.
  • AI builders 관련 X 커뮤니티를 검색해 커뮤니티 ID, 이름, 멤버 수, 설명을 보여 줘.
  • AI founders 관련 리스트를 검색해 상위 10개 리스트의 ID, 이름, 설명, 멤버 수를 보여 줘.

프레임워크 가이드

원하는 프레임워크에서 TwexAPI MCP 도구로 에이전트를 만들어 보세요.

LangChain

TwexAPI MCP 도구를 LangChain과 LangGraph 에이전트에 연결합니다.

CrewAI

하나의 TwexAPI MCP 연결을 공유하는 리서치 크루를 만듭니다.

Pydantic AI

Streamable HTTP MCP 도구로 타입 안전한 에이전트를 만듭니다.

Google ADK

Gemini 기반 ADK 에이전트에 TwexAPI 도구를 추가합니다.

Mastra

TypeScript 에이전트를 원격 TwexAPI MCP 도구에 연결합니다.

노코드 워크플로

에이전트 결과를 n8n, Zapier, Make, Pipedream으로 넘깁니다.

AI 에이전트 스킬

TwexAPI 스킬을 설치하면 MCP 연결 없이도 AI 코딩 에이전트가 TwexAPI API를 깊이 이해합니다. 에이전트가 API 통합 코드를 작성하고, MCP 연결을 설정하고, TwexAPI 모범 사례를 따를 수 있습니다.

npx skills add twexapi-dev/x-api-scraper-cli

이 페이지가 도움이 되었나요?