pokewiki - SDK CLI para wikis Pokémon

pokewiki

Consulte informações em quatro wikis Pokémon — Bulbapedia (en), 神奇宝贝百科 / 52poke (zh), PokéWiki (de), WikiDex (es) — por meio de uma única CLI em inglês: pokewiki.

pokemon-wikis-cli é uma ferramenta independente e não oficial — não afiliada nem endossada por nenhuma dessas wikis ou pela The Pokémon Company.

Quando usar esta skill

Recorra a ela para qualquer pergunta factual sobre Pokémon: tipo/estatísticas/habilidades de uma espécie, o que um movimento faz, matchups de tipos, linhas evolutivas, quais Pokémon compartilham uma característica, ou fatos específicos de jogos, como o roster disponível em um título, a Pokédex regional ou a regulamentação competitiva atual.

Trate as wikis como a verdade absoluta, não sua memória. O detalhamento Pokémon é vasto, versionado e atualizado com frequência — os rosters mudam conforme a regulamentação, os nomes variam por idioma, um "fato" que você lembra pode ser de um jogo errado ou simplesmente incorreto. Quando a precisão importa, consulte antes de responder. O custo de uma consulta é um comando; o custo de afirmar com confiança um tipo, estatística ou "este Pokémon está neste jogo" errado é uma resposta incorreta que o usuário terá que corrigir.

Obtendo a CLI

Resolva o comando com o script incluído (resolva o caminho relativo a este SKILL.md). Ele imprime o comando a ser usado ou sai com código diferente de zero e instruções de instalação:

scripts/ensure-pokewiki.sh

Ele verifica, nesta ordem: se pokewiki já está no PATH, depois uvx (executa diretamente do GitHub — sem instalação; o uv armazena em cache a compilação após o primeiro uso). Se nenhum estiver presente, imprime opções de instalação e sai com código 1 — não instale nada por conta própria; apresente as opções e deixe o usuário escolher.

Todos os exemplos abaixo escrevem pokewiki; substitua pelo que o script imprimir.

Escolha uma wiki: -w é obrigatório

Cada consulta é executada contra exatamente uma wiki, escolhida com -w / --wiki:

-w	wiki	use para
en	Bulbapedia	a cobertura mais ampla em inglês; escolha padrão para inglês
zh-hans	52poke (神奇宝贝百科)	consultas em chinês; saída simplificada
zh-hant	52poke	consultas em chinês; saída tradicional
de	PokéWiki	alemão; sem CirrusSearch — search simples funciona, mas search -c não; use filter
es	WikiDex	espanhol

Combine a wiki com o idioma do usuário ou com o local onde o fato está. Um título de página é específico de cada wiki e não traduzido — Pikachu em en, 皮卡丘 em zh-hans.

Os quatro comandos

Comando	Use quando
search <consulta>	Você precisa encontrar uma página ou não sabe o título exato (busca difusa, texto completo).
filter <chaves…>	Você quer todos os Pokémon que correspondem a uma interseção de características (tipo, geração, grupo de ovos, região, habilidade).
page <título>	Você conhece a página (ou um nome que redireciona para ela) e deseja o wikitexto bruto — estatísticas, tipo, habilidades, conjuntos de movimentos.
keywords [eixo]	Você precisa ver as chaves de restrição válidas para filter.

pokewiki search "皮卡丘" -w zh-hans              # encontra uma página pelo nome difuso
pokewiki page "Garchomp" -w en                   # wikitexto bruto (segue redirecionamentos)
pokewiki filter type:dragon region:hisui -w en   # todos os tipos Dragão da Dex de Hisui
pokewiki keywords region -w en                   # chaves region: válidas na Bulbapedia

Adicione --format json a qualquer comando para obter saída estruturada para analisar; omita para ler os resultados diretamente. Consulte references/cli.md para todas as flags e códigos de saída.

Escolhendo entre eles

• Conhece o assunto exato (um Pokémon, movimento ou habilidade nomeados) → page. Ele segue redirecionamentos, então um nome simples geralmente resolve para o artigo.
• Procurando a página certa / sem certeza do título → search. Em seguida, use page no melhor resultado para lê-lo.
• Enumerando por característica ("todos os Elétricos da geração 1", "tipos Água/Terreno") → filter. As chaves fazem interseção AND; passe-as separadas por espaço ou vírgula.
• Restringindo uma busca textual por uma característica → search "<texto>" -c type:electric (apenas wikis com CirrusSearch — não de).

Vocabulário de restrições para filter

As chaves são em inglês e resolvem para a categoria nativa de cada wiki. Dois tipos:

• Universal (idêntico em todas as wikis): type: (18), gen: (1–9), egg: (14 grupos de ovos).
• Por wiki (apenas onde essa wiki categoriza dessa forma): region: em en (9) e zh (10); ability: apenas em zh (312). Usar uma em uma wiki que não a possui resulta em um erro claro que nomeia as wikis que a suportam.

Execute pokewiki keywords para a união de todas as chaves, ou pokewiki keywords -w <wiki> para ver as chaves de uma wiki com seus nomes de categoria nativos. Para qualquer coisa fora deste vocabulário, use search.

Um padrão prático: consultas em várias etapas

Perguntas reais geralmente encadeiam os comandos — e encadear também é como você evita responder com base em memória desatualizada. Para encontrar um contra-ataque a uma ameaça dentro do roster disponível de um jogo específico:

1. Use search com o nome da ameaça para confirmar que você tem a página certa.
2. Use page nela para ler seu tipo real, estatísticas e habilidade — não o que você lembra.
3. Use page no artigo do roster/regulamentação do jogo para ver o que está realmente disponível (este é o passo que detecta "Eu assumi que X estava neste jogo").
4. Use filter com o tipo relevante dentro desse conjunto para enumerar opções reais.

Cada passo substitui uma suposição por um fato da wiki. Quando uma consulta contradiz o que você estava prestes a dizer, confie na consulta.

Conformidade (não a contorne)

Esta ferramenta é deliberadamente educada com as wikis, e isso é uma característica. Ela usa apenas a API MediaWiki (nunca scraping), serializa e limita a taxa de requisições, armazena em cache por 24h e envia um User-Agent identificador. Não tente paralelizá-la, ignorar o cache em um loop ou adicionar as wikis japonesa, francesa ou italiana (excluídas porque bloqueiam acesso automatizado). Se uma requisição for limitada (código de saída 4), aguarde e tente novamente uma vez — não insista.

Referências

• references/cli.md — todos os comandos, argumentos, flags, formato de saída e códigos de saída.