Habilidade de Consulta da Subscan API para Openclaw

Uma habilidade de IA especializada para consultar dados de blockchain multi-chain através da Subscan API, com roteamento automático de endpoint e tratamento inteligente de erros.

carlhong
v1.0.0
Apr 14, 2026
1
734
0

Instalar e Baixar

1. ClawHub CLI

A maneira mais rápida de instalar uma habilidade diretamente do registro.

npx clawhub@latest install subscan-api

2. Instalação Manual

Copie a pasta da habilidade para um desses locais

Global
~/.openclaw/skills/
Espaço de trabalho
<project>/skills/

Prioridade: Espaço de Trabalho > Local > Integrado

3. Instalação do Prompt

Copie este prompt para o OpenClaw para instalá-lo automaticamente.

Ajude-me a instalar o subscan-api usando o Clawhub. Se o Clawhub não estiver instalado, instale-o primeiro (npm i -g clawhub).

Prefere baixar?

Obtenha os arquivos originais da habilidade em um arquivo ZIP.

O que é Habilidade de Consulta da Subscan API?

A Habilidade de Consulta da Subscan API é uma integração sofisticada projetada para transformar prompts em linguagem natural em consultas precisas de dados de blockchain. Ela serve como uma ponte entre os usuários e a vasta quantidade de dados indexados pela Subscan, suportando mais de 185 endpoints em múltiplas redes como Polkadot, Ethereum e Kusama. Ao utilizar documentação swagger localizada e tabelas de roteamento otimizadas, garante que as consultas técnicas sejam resolvidas com alta precisão e velocidade.

Construída para desenvolvedores e pesquisadores, esta habilidade automatiza a complexidade de chamadas manuais de API. Lida com tudo, desde a gestão de API key e normalização de nomes de rede até a construção de corpos JSON complexos. Esteja você procurando hashes de transação específicos, saldos de conta ou detalhes de governança, este componente do Openclaw Skills fornece uma interface simplificada para exploração on-chain.

Casos de uso do Habilidade de Consulta da Subscan API

  • Rastreamento de transferências e transações em tempo real através de diferentes redes de blockchain.
  • Recuperação de informações detalhadas de contas, recompensas de staking e histórico de saldo.
  • Monitoramento de propostas de governança, status de votação e dados de identidade on-chain.
  • Auditoria de detalhes específicos de blocos e dados extrínsecos para fins de depuração ou pesquisa.

Como o Habilidade de Consulta da Subscan API funciona

  1. A habilidade verifica se há uma API key da Subscan salva localmente e solicita o registro em pro.subscan.io caso não encontre.
  2. Analisa a solicitação em linguagem natural do usuário para combinar palavras-chave com uma tabela de roteamento de alta frequência (routing.yaml).
  3. Se nenhuma correspondência for encontrada no caminho rápido, ele recorre a um catálogo Swagger completo para identificar o endpoint da API correto.
  4. Identifica os parâmetros necessários, solicita as informações ausentes ao usuário (um campo por vez) e normaliza os nomes das redes (por exemplo, 'dot' para 'polkadot').
  5. A habilidade executa a solicitação autenticada através de um script Python e processa a resposta JSON bruta.
  6. Os dados são formatados em tabelas Markdown legíveis ou listas de objetos para o usuário, com lógica embutida para novas tentativas automáticas em limites de taxa ou falhas de rede.

Configuração do Habilidade de Consulta da Subscan API

Para começar com a habilidade da Subscan API, certifique-se de ter uma API key do portal Subscan Pro. Instale a habilidade em seu ambiente e use os seguintes comandos para configurar suas credenciais:

# Verifique se uma API key já está configurada
python3 "$SKILL_DIR/scripts/subscan_api.py" check-key

# Salve uma nova API key
python3 "$SKILL_DIR/scripts/subscan_api.py" save-key <YOUR_SUBSCAN_API_KEY>

Esquema de Dados e Taxonomia de Habilidade de Consulta da Subscan API

A habilidade utiliza um sistema de referência estruturado para garantir a precisão e minimizar a latência. Os dados são organizados da seguinte forma:

Arquivo Descrição
routing.yaml Uma tabela de pesquisa de alta frequência que mapeia palavras-chave para rotas específicas da API.
endpoint-details.yaml Contém requisitos de parâmetros, modelos de corpo e chaves de resposta prioritárias.
swagger.yaml O catálogo abrangente de todos os mais de 185 endpoints da Subscan suportados, usado para fallback.
subscan_api.py O script de execução principal que lida com interações CLI e solicitações HTTP.

Recursos avançados do Habilidade de Consulta da Subscan API

  • Fallback Inteligente: Transita automaticamente de uma tabela de roteamento de caminho rápido para uma varredura Swagger completa se a consulta for complexa.
  • Normalização de Rede: Mapeia perfeitamente aliases (como 'ksm' ou 'bsc') para os identificadores de rede Subscan corretos.
  • Resolução Proativa de Erros: Em vez de erros brutos, fornece etapas acionáveis para códigos de status 400, 401, 404 e 429.
  • Suporte Multi-Chain: Constrói URLs base dinamicamente com base na rede de destino fornecida na solicitação do usuário.
  • Paginação com Consciência de Contexto: Inclui lembretes para especificar parâmetros de página quando grandes conjuntos de dados são retornados.

SKILL.md


Carregamento

Habilidades relacionadas do Openclaw

METADATA

Github Stars: 0
forks: 0

Apresentou*