tweetapi/agent-skill

TweetAPI 읽기 전용 워크플로우

공개 Twitter/X 데이터를 위해 TweetAPI를 사용하며, 작업을 읽기 전용으로 유지하고, 자격 증명은 서버 측에 보관하며, 할당량 사용은 명시적으로 합니다.

안전 경계 강제

• 공개 데이터 또는 공개 문서를 검색하는 작업만 허용합니다.
• 게시, 답글, 삭제, 좋아요, 리트윗, 북마크, 팔로우, 언팔로우, 프로필/리스트/커뮤니티 상태 변경을 수행하지 않습니다.
• 직접 메시지, 받은 편지함, 알림, 비공개 계정 분석, 결제, API 키 관리, 관리, 내부 엔드포인트에 접근하지 않습니다.
• Twitter/X 로그인 또는 세션 자동화를 수행하지 않습니다.
• 비밀번호, 쿠키, authToken, ct0, TOTP 코드, 프록시 자격 증명, 개인 메시지 내용을 요청, 수락, 저장, 전달하지 않습니다.
• 더 넓은 공개 API 문서에 나타나더라도 해당 비밀을 필요로 하는 엔드포인트를 호출하지 않습니다.
• HTTP 메서드를 안전성의 충분한 증거로 간주하지 않습니다. 작업의 효과와 필수 필드를 확인합니다.
• X Corp.와의 제휴를 주장하지 않습니다. TweetAPI는 타사 서비스입니다.

요청된 작업이 이 경계를 넘는 경우, 제외된 작업을 설명하고 읽기 전용 대안을 제시합니다. 더 넓은 TweetAPI 제품이 더 많은 작업을 지원한다는 이유만으로 경계를 약화시키지 않습니다.

실행 경로 선택

사용자가 에이전트가 문서를 검사하거나 제한된 공개 데이터 조회를 수행하기를 원할 때 호스팅된 MCP 서버를 사용합니다. API 키가 대화에 들어가지 않도록 OAuth 흐름을 선호합니다. 클라이언트를 구성하거나 라이브 도구를 호출하기 전에 references/hosted-mcp.md를 읽습니다.

애플리케이션을 수정할 때는 서버 측 REST 또는 공식 SDK를 사용합니다. 통합 코드를 작성하기 전에 references/integration.md를 읽습니다.

문서 전용 질문의 경우, 라이브 데이터 요청 없이 정식 공개 소스를 읽습니다. 엔드포인트 이름, 매개변수, 응답 필드 또는 설치 지침이 최신 상태여야 할 때마다 references/sources.md를 읽습니다.

워크플로우 따르기

1. 요청이 문서 전용인지, 라이브 조회인지, 애플리케이션 통합인지 식별합니다.
2. 엔드포인트 또는 도구를 선택하기 전에 안전 경계에 대해 작업을 확인합니다.
3. 복사된 엔드포인트 카탈로그에 의존하지 않고 현재 공개 문서를 참조합니다.
4. 에이전트 사용 시 MCP OAuth를, 애플리케이션 코드에는 서버 측 API 키를 선택합니다.
5. 라이브 요청 전에 할당량을 소비한다고 명시합니다.
6. 최대 한 번의 라이브 도구 호출을 수행하고 기본적으로 한 페이지를 검색합니다.
7. 페이지네이션 커서를 자동으로 따르지 않고 반환합니다. 다음 페이지 전에 물어봅니다.
8. HTTP 2xx 응답만 성공으로 간주합니다. 인증, 할당량 및 유효성 검사 오류를 명확하게 표시합니다.
9. 모의(mock) 또는 픽스처(fixture)로 애플리케이션 변경 사항을 검증합니다. 사용자가 명시적으로 승인하지 않는 한 설정 또는 테스트 중에 라이브 할당량을 사용하지 않습니다.

할당량 및 페이지네이션 제어

모든 라이브 데이터 요청은 할당량을 소비합니다. 재시도 및 후속 페이지는 추가 할당량을 소비할 수 있습니다.

• 자동 페이지네이션하지 않습니다.
• 라이브 요청을 자동으로 재시도하지 않습니다.
• 단지 구성을 증명하기 위해 라이브 "스모크 테스트"를 실행하지 않습니다.
• 첫 페이지 이후 중단하고 반환된 커서를 노출합니다.
• 사용자가 명시적으로 다중 페이지 애플리케이션 동작을 요청하는 경우 페이지, 항목 및 총 요청 수에 대해 구성 가능한 최대값을 구현합니다. 무제한 페이지네이션 헬퍼를 사용하지 않습니다.

자격 증명 보호

• TWEETAPI_API_KEY를 서버 전용 환경 변수 또는 비밀 관리자에 보관합니다.
• 브라우저 코드, 모바일 번들, 소스 제어, 로그, 예제 또는 프롬프트에 포함하지 않습니다.
• YOUR_API_KEY는 문서 플레이스홀더로만 사용합니다.
• 호환되는 에이전트 클라이언트의 경우 https://mcp.tweetapi.com/mcp와 함께 OAuth를 선호합니다.
• 로깅 전에 민감한 사용자 입력이 포함될 수 있는 경우 응답 데이터를 삭제합니다.

소스 정확성 유지

공개 제품 문서는 이 스킬보다 더 넓은 제품을 다룹니다. 문서화된 모든 엔드포인트가 여기서 허용된다고 추론하지 마십시오. OpenAPI URL, Postman 컬렉션, SDK 메서드 또는 MCP 도구 이름을 임의로 만들지 마십시오. 소스 참조에서 현재 세부 정보를 확인합니다.

소스가 불일치할 경우, 충돌을 보고하고 해결될 때까지 라이브 호출을 피합니다.