bitquery-automation

bitquery-automation skill 개요

bitquery-automation이 하는 일

bitquery-automation은 Composio의 Rube MCP 서버를 통해 Bitquery 작업을 자동화하는 Claude skill입니다. Bitquery의 블록체인 데이터가 필요하지만, 하드코딩된 도구 이름이나 오래된 스키마에 의존하면 안 되는 워크플로를 위해 설계되었습니다. 이 skill의 핵심 원칙은 단순합니다. 먼저 사용 가능한 Rube 도구를 검색하고, 현재 스키마와 연결 상태를 확인한 뒤에만 Bitquery 액션을 실행하는 것입니다.

Workflow Automation 팀에 가장 잘 맞는 경우

bitquery-automation skill은 이미 Claude에서 MCP 도구를 사용하고 있고, 반복 가능한 Bitquery 워크플로를 만들고 싶은 개발자, 애널리스트, 자동화 빌더에게 적합합니다. 대표적인 작업에는 사용 가능한 Bitquery 액션 탐색, 지갑 또는 토큰 데이터 확인, 블록체인 데이터 조회 흐름 구성, 자연어 분석 요청을 도구 기반 실행 계획으로 바꾸는 일이 포함됩니다.

핵심 차별점: 스키마 확인을 먼저 한다는 점

API 필드를 추측하는 일반 프롬프트와 달리, bitquery-automation은 실행 전에 에이전트가 RUBE_SEARCH_TOOLS를 호출하도록 지시합니다. 이 단계가 중요한 이유는 MCP 도구 스키마가 바뀔 수 있고, Bitquery 액션마다 특정 필수 필드가 있을 수 있으며, 잘못된 가정은 호출 실패나 불완전한 데이터로 이어질 수 있기 때문입니다. 이 skill은 작지만, 도구 탐색, 연결 확인, 실행, 반환 데이터 처리라는 올바른 순서를 강제한다는 점에서 가치가 있습니다.

도입 전에 알아야 할 제약

이 skill은 독립 실행형 Bitquery SDK, 크롤러, 대시보드가 아닙니다. Rube MCP와 Composio를 통해 관리되는 활성 Bitquery 연결이 필요합니다. 저장소 경로에는 SKILL.md만 있으므로 참고할 헬퍼 스크립트, 예제, 번들 레퍼런스가 없습니다. 완성형 애플리케이션 템플릿이 필요한 경우가 아니라, Rube 기반 Bitquery 자동화를 위한 체계적인 에이전트 워크플로가 필요할 때 설치하는 것이 좋습니다.

bitquery-automation skill 사용 방법

bitquery-automation 설치 및 설정

Composio skills 저장소에서 skill을 설치합니다.

npx skills add ComposioHQ/awesome-claude-skills --skill bitquery-automation

그다음 MCP 서버 엔드포인트를 추가해 클라이언트에서 Rube MCP를 설정합니다.

https://rube.app/mcp

skill을 사용하기 전에 RUBE_SEARCH_TOOLS를 사용할 수 있는지 확인하세요. 이어서 toolkit bitquery로 RUBE_MANAGE_CONNECTIONS를 사용하고, 연결 상태가 ACTIVE가 아니라면 반환된 인증 절차를 완료합니다. 연결이 활성화되기 전에는 에이전트에게 Bitquery 작업을 실행하라고 요청하지 마세요. 대부분의 실패는 프롬프트 자체가 아니라 MCP 접근 권한 누락이나 완료되지 않은 Bitquery 연결에서 발생합니다.

skill에 제공해야 할 입력

좋은 bitquery-automation usage를 위해서는 에이전트에게 구체적인 블록체인 질문, 대상 체인 또는 네트워크, 엔티티 유형, 식별자, 기간, 출력 형식을 제공해야 합니다. 약한 입력은 “토큰 활동 가져와줘”입니다. 좋은 입력은 다음과 같습니다.

“Use bitquery-automation to find recent transfer activity for token contract 0x... on Ethereum for the last 24 hours. First discover the current Bitquery tools through Rube, verify the Bitquery connection, then return the fields available for transfers and summarize the top 10 transfers in a table.”

이 방식이 더 잘 작동하는 이유는 에이전트가 구체적인 사용 사례를 기준으로 도구를 검색하고, 현재 스키마에 맞춰 요청을 매핑하며, 필수 필드를 추측하는 일을 피할 수 있기 때문입니다.

실제로 권장되는 워크플로

신뢰할 수 있는 bitquery-automation guide는 다음 네 단계로 진행됩니다.

1. 특정 Bitquery 작업에 대해 에이전트가 skill을 호출하도록 요청합니다.
2. 실제 사용 사례를 쿼리로 사용해 먼저 RUBE_SEARCH_TOOLS를 실행하도록 요구합니다.
3. toolkit bitquery에 대해 RUBE_MANAGE_CONNECTIONS를 확인하고 ACTIVE 상태인지 검증합니다.
4. 탐색으로 반환된 스키마를 사용해 선택한 Bitquery 도구를 실행합니다.

첫 번째 도구 검색에서 후보가 여러 개 반환되면, 실행 전에 에이전트에게 어떤 도구를 선택했는지와 그 이유를 설명하도록 요청하세요. “transaction”, “trade”, “transfer”, “balance”가 서로 다른 Bitquery 기능에 매핑될 수 있는 분석 프롬프트에서 특히 유용합니다.

의존하기 전에 읽어야 할 파일

먼저 composio-skills/bitquery-automation/SKILL.md를 확인하세요. 이 파일에는 전제 조건, Rube MCP 설정, 도구 탐색, 연결 관리, 핵심 실행 패턴까지 전체 운영 모델이 담겨 있습니다. 이 skill 경로에는 README.md, rules/, resources/, references/, scripts/ 파일이 없으므로 upstream SKILL.md가 기준 문서입니다. toolkit별 동작은 composio.dev/toolkits/bitquery에 연결된 Bitquery toolkit 문서도 함께 확인하세요.

bitquery-automation skill FAQ

bitquery-automation만 있으면 Claude에서 Bitquery를 사용할 수 있나요?

Claude 환경에서 Rube MCP에 접근할 수 있고 Composio를 통한 활성 Bitquery 연결이 있다면 충분합니다. 이 skill에는 Bitquery 자격 증명, 커스텀 쿼리, 로컬 데이터 파이프라인이 포함되어 있지 않습니다. 대신 에이전트가 사용 가능한 Bitquery 도구를 안전하게 탐색하고 호출하는 방법을 알려줍니다.

일반 프롬프트보다 어떤 점이 더 낫나요?

일반 프롬프트는 도구 이름을 환각하거나 존재하지 않는 필드를 만들어낼 수 있습니다. bitquery-automation은 RUBE_SEARCH_TOOLS를 통한 실시간 도구 탐색을 요구해 안정성을 높입니다. 이것이 이 skill을 설치하는 주된 이유입니다. 에이전트가 기억에 의존하는 대신 현재 Rube/Bitquery 스키마에 맞춰 동작해야 하기 때문입니다.

초보자도 사용하기 쉬운가요?

MCP의 기본 개념을 이해하는 사용자에게는 비교적 친절하지만, MCP 서버를 한 번도 설정해 본 적이 없는 사람에게까지 쉬운 도구는 아닙니다. 설정 자체는 짧지만, 워크플로는 Rube MCP를 연결하고, Bitquery toolkit을 승인하며, 실패 시 도구 응답을 확인할 수 있다는 전제를 둡니다.

이 skill을 쓰지 말아야 할 때는 언제인가요?

Bitquery가 필요 없는 작업, 자체 데이터베이스에서 수행하는 오프라인 블록체인 분석, 에이전트 판단 없이 감사 가능한 결정론적 코드가 필요한 프로덕션 워크플로에는 사용하지 마세요. 조직에서 서드파티 MCP 연결이나 Composio 관리 toolkit 접근을 승인할 수 없는 경우에도 적합하지 않습니다.

bitquery-automation skill 개선 방법

bitquery-automation 프롬프트 개선하기

결과를 가장 빠르게 개선하는 방법은 작업을 대화형이 아니라 실행 가능한 형태로 만드는 것입니다. 체인, 자산, 지갑, 컨트랙트, 시간 범위, 필터, 원하는 출력 형식을 포함하세요. 또한 원시 반환 필드가 필요한지, 요약 답변이 필요한지, 재사용 가능한 워크플로가 필요한지도 명시하는 것이 좋습니다.

더 나은 프롬프트 패턴은 다음과 같습니다.

“Use bitquery-automation for Workflow Automation. Discover current Bitquery tools first. Check the Bitquery connection. Then retrieve [data type] for [chain/entity] over [time range], using only fields confirmed by the discovered schema. If required fields are missing, ask before execution.”

흔한 실패 패턴 피하기

가장 흔한 실패는 도구 탐색을 건너뛰고 스키마를 추측하는 것입니다. 두 번째는 Bitquery 연결이 활성화되기 전에 실행을 시도하는 경우입니다. 세 번째는 네트워크, 식별자, 시간 범위를 지정하지 않은 모호한 분석 질문을 하는 것입니다. 첫 Bitquery 호출 전에 탐색, 연결 확인, 짧은 실행 계획을 명시적으로 요구하면 이런 문제를 줄일 수 있습니다.

첫 결과 이후 반복 개선하기

초기 응답을 받은 뒤에는 어떤 tool slug와 스키마 필드가 사용되었는지 에이전트에게 보여 달라고 요청하세요. 결과가 너무 넓다면 체인, 컨트랙트, 블록 범위, 타임스탬프, 트랜잭션 유형, 주소 목록으로 좁히세요. 결과가 너무 빈약하다면 같은 도구 호출을 억지로 반복하게 하지 말고, 더 정확한 사용 사례로 다시 탐색하도록 요청하세요.

팀 워크플로에 맞게 skill 확장하기

팀은 자주 수행하는 Bitquery 작업을 중심으로 내부 예제를 추가해 bitquery-automation을 개선할 수 있습니다. 예를 들어 토큰 모니터링, 지갑 조사, DEX 거래 요약, 컴플라이언스 검토용 내보내기 등이 있습니다. 단, 이런 예제도 스키마 인식 방식으로 유지해야 합니다. 프롬프트에 오래된 필드 이름을 고정하지 말고, 매번 도구를 다시 탐색하라고 에이전트에게 지시하세요. 이렇게 하면 이 skill의 핵심 장점을 유지하면서 반복 워크플로를 더 빠르게 실행할 수 있습니다.