X Tools for Claude MCP

Claude MCP를 위한 X 도구

Claude가 자연어로 Twitter를 효율적으로 검색하고 사용자 의도에 따라 결과를 표시할 수 있도록 지원하는 가벼운 오픈소스 툴킷입니다. 원시 데이터 보기와 선택적 분석 모두에 적합하도록 설계되었습니다.

특징

• 자연어 검색 : Claude에게 Twitter에서 일반 영어로 검색해 달라고 요청하세요
• Twitter 검색 : 자연어 또는 고급 Twitter 구문을 사용하여 트윗 검색
• 전문적인 포맷 : 깔끔하고 마크다운 포맷의 트윗 표시
• 유연한 출력 : 요청 사항에 따라 원시 트윗을 표시하거나 분석을 추가합니다.
• 고급 필터링 : 키워드, 사용자, 날짜, 참여 지표 등을 기준으로 트윗 찾기
• 페이지 번호 매기기 지원 : 필요할 때 검색당 기본 20개 이상의 트윗을 검색합니다.

설치

필수 조건

• Node.js v16+
• 데스크톱용 클로드
• "The Old Bird API"(Twitter154) 엔드포인트에 액세스할 수 있는 무료 RapidAPI 키

RapidAPI 키 설정

1. RapidAPI에서 The Old Bird API를 방문하세요
2. RapidAPI 계정이 없으면 등록하세요.
3. API 구독하기(무료 계층이 있습니다)
4. 구독 후 대시보드에서 RapidAPI 키를 복사하세요.

설정 단계

1. 이 저장소를 복제합니다 .지엑스피1
2. 종속성 설치 :
   npm install
3. 구성을 생성하세요 :
   • Claude Desktop 디렉토리의 mcp.json 에 mcp.json.example 복사하세요.
   • RapidAPI 키와 올바른 파일 경로를 포함하도록 mcp.json 편집하세요.
   { "mcpServers": { "x-tools": { "command": "node", "args": ["YOUR_ABSOLUTE_PATH_TO/main.js"], "env": { "RAPIDAPI_KEY": "your_rapidapi_key" } } } }
4. 데스크톱에 Claude 구성 :
   • Windows의 경우: mcp.json 파일을 %APPDATA%\Claude\ 에 넣으세요.
   • macOS의 경우: mcp.json 파일을 ~/Library/Application Support/Claude/ 에 넣으세요.
   • claude-rules.md 및 knowledge/TwitterSearchSyntaxGuide.txt Claude 지식 기반 디렉토리에 복사합니다.
   • 변경 사항을 적용하려면 Claude Desktop을 다시 시작하세요.

사용 가능한 도구

트위터 검색

이 도구는 주로 자연어를 사용하도록 설계되었습니다. Claude에게 Twitter에서 무언가를 검색해 달라고 요청하면 요청을 해석해 줍니다.

자연어 또는 고급 구문을 사용하여 Twitter 검색:

• query : 검색 쿼리(Twitter의 고급 검색 연산자 지원)
• section : "최신" 또는 "상위" 결과(기본값: "최신")
• limit : 반환할 트윗 수 (기본값: 20)

자연어 예시

간단한 쿼리

클로드에게 물어보세요:

사용자 중심 쿼리

클로드에게 물어보세요:

복잡한 자연 쿼리

클로드에게 물어보세요:

분석 요청

클로드에게 물어보세요:

직접적인 구문 예

직접적인 구문을 선호하는 분들을 위해:

필수 파일

이 도구에는 올바르게 설정해야 하는 몇 가지 중요한 파일이 포함되어 있습니다.

• main.js : 메인 애플리케이션 파일
• tools/twitter.js : Twitter 검색 구현
• claude-rules.md : Claude가 검색 결과를 적절하게 표시하기 위한 지침
• knowledge/TwitterSearchSyntaxGuide.txt : Twitter 검색 구문에 대한 참조 가이드

Claude 설정에서 이러한 모든 파일이 올바른 위치에 배치되었는지 확인하세요.

검색 구문

이 도구는 Claude가 자연어에서 적용할 수 있는 모든 표준 Twitter 검색 연산자를 지원합니다.

사용자

• from:username - 특정 계정에서 보낸 트윗
• to:username - 특정 계정에 대한 답장
• @username - 해당 계정을 언급하는 트윗

미디어 및 링크

• filter:media - 모든 미디어가 포함된 트윗
• filter:images - 이미지가 포함된 트윗
• filter:native_video - 비디오가 포함된 트윗
• filter:links - 링크가 포함된 트윗

날짜

• since:YYYY-MM-DD - 이 날짜 이후의 트윗
• until:YYYY-MM-DD - 이 날짜 이전의 트윗

약혼

• min_retweets:n - 최소 n번 리트윗된 트윗
• min_faves:n - 최소 n개의 좋아요를 받은 트윗
• min_replies:n - 최소 n개의 답변이 있는 트윗

문제 해결

일반적인 문제:

• API 키를 찾을 수 없습니다 . RapidAPI 키가 mcp.json 에 올바르게 설정되어 있는지 확인하세요.
• 경로 오류 : Windows에서 적절한 이스케이프( \\ )를 사용하여 전체 절대 경로를 사용하고 있는지 확인하세요.
• 검색 결과 없음 : 검색어가 유효하고 너무 제한적이지 않은지 확인하세요.
• Claude 동작 문제 : 유연한 출력 지침이 포함된 최신 버전의 claude-rules.md 가 있는지 확인하세요.
• 누락된 파일 : claude-rules.md 및 TwitterSearchSyntaxGuide.txt 가 Claude 규칙 및 지식 기반에 제대로 추가되었는지 확인하세요.

개발

도구를 수정하려면:

1. tools/ 디렉토리에 있는 파일을 편집하세요
2. 필요한 경우 formatTwitterResults() 함수의 서식을 업데이트하세요.
3. 변경 사항을 확인하려면 데스크톱용 Claude를 다시 시작하세요.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다.

감사의 말

• Anthropic의 모델 컨텍스트 프로토콜(MCP)
• RapidAPI Twitter154 API
• 악시오스
• 조드

참고 : 이 도구는 Claude AI 어시스턴트와 함께 작동하도록 설계되었으며 사용자 의도에 따라 유연한 표시 옵션으로 Twitter 검색 결과를 제공합니다.