AirswitchAsa/pokemon-wikis-cli

pokewiki

Consulta información en cuatro wikis Pokémon — Bulbapedia (en), 神奇宝贝百科 / 52poke (zh), PokéWiki (de), WikiDex (es) — a través de un único CLI en inglés: pokewiki.

pokemon-wikis-cli es una herramienta independiente no oficial — no está afiliada ni respaldada por ninguna de estas wikis ni por The Pokémon Company.

Cuándo usar este skill

Úsalo para cualquier pregunta factual sobre Pokémon: los tipos/estadísticas/habilidades de una especie, qué hace un movimiento, tablas de tipos, líneas evolutivas, qué Pokémon comparten un rasgo, o datos específicos de un juego como el roster disponible de un título, la Pokédex regional, o la regulación competitiva actual.

Trata a las wikis como fuente de verdad, no a tu memoria. El detalle de Pokémon es vasto, versionado y se actualiza con frecuencia — los rosters cambian según la regulación, los nombres difieren según el idioma, un "dato" que recuerdas puede ser del juego equivocado o simplemente incorrecto. Cuando la precisión importa, consulta antes de responder. El costo de una consulta es un comando; el costo de afirmar con seguridad un tipo, estadística o "este Pokémon está en este juego" erróneo es una respuesta incorrecta que el usuario debe detectar.

Obtener el CLI

Resuelve el comando con el script incluido (resuelve su ruta relativa a este SKILL.md). Imprime el comando a usar, o sale con código distinto de cero e instrucciones de instalación:

scripts/ensure-pokewiki.sh

Verifica, en orden: si pokewiki ya está en PATH, luego uvx (lo ejecuta directamente desde GitHub — sin instalación; uv cachea la compilación tras el primer uso). Si ninguno está presente, imprime opciones de instalación y sale con 1 — no instales nada tú mismo; muestra las opciones y deja que el usuario elija.

Todos los ejemplos a continuación escriben pokewiki; sustituye por lo que imprima el script.

Elegir una wiki: -w es obligatorio

Cada consulta se ejecuta contra una sola wiki, elegida con -w / --wiki:

-w	wiki	úsala para
en	Bulbapedia	la cobertura en inglés más amplia; opción predeterminada para inglés
zh-hans	52poke (神奇宝贝百科)	consultas en chino; salida simplificada
zh-hant	52poke	consultas en chino; salida tradicional
de	PokéWiki	alemán; sin CirrusSearch — search simple funciona, pero search -c no; usa filter
es	WikiDex	español

Elige la wiki según el idioma del usuario, o según dónde resida el dato. Un título de página es por wiki y no se traduce — Pikachu en en, 皮卡丘 en zh-hans.

Los cuatro comandos

Comando	Úsalo cuando
search <consulta>	Necesitas encontrar una página o no sabes su título exacto (difuso, texto completo).
filter <claves…>	Quieres todos los Pokémon que coincidan con una intersección de rasgos (tipo, generación, grupo huevo, región, habilidad).
page <título>	Conoces la página (o un nombre que redirige a ella) y quieres su wikitexto sin procesar — estadísticas, tipos, habilidades, movimientos.
keywords [eje]	Necesitas ver las claves de restricción válidas para filter.

pokewiki search "皮卡丘" -w zh-hans              # encontrar una página por nombre difuso
pokewiki page "Garchomp" -w en                   # wikitexto sin procesar (sigue redirecciones)
pokewiki filter type:dragon region:hisui -w en   # todos los tipos dragón de la dex de Hisui
pokewiki keywords region -w en                   # claves region: válidas en Bulbapedia

Añade --format json a cualquier comando para obtener salida estructurada y analizable; omítelo para leer los resultados tú mismo. Consulta references/cli.md para todas las banderas y códigos de salida.

Cómo elegir entre ellos

• Conoces el tema exacto (un Pokémon, movimiento o habilidad con nombre) → page. Sigue redirecciones, por lo que un nombre simple suele resolver al artículo.
• Buscas la página correcta / no estás seguro del título → search. Luego page el mejor resultado para leerlo.
• Enumerar por rasgo ("todos los tipo Eléctrico de gen-1", "tipos Agua/Tierra") → filter. Las claves se intersectan con AND; pásalas separadas por espacios o comas.
• Acotar una búsqueda de texto por un rasgo → search "<texto>" -c type:electric (solo wikis con CirrusSearch — no en de).

Vocabulario de restricciones para filter

Las claves están en inglés y se resuelven a las categorías nativas de cada wiki. Dos tipos:

• Universal (idéntica en todas las wikis): type: (18), gen: (1–9), egg: (14 grupos huevo).
• Por wiki (solo donde esa wiki categoriza así): region: en en (9) y zh (10); ability: solo en zh (312). Usar una en una wiki que no la tiene es un error claro que nombra las wikis que sí la soportan.

Ejecuta pokewiki keywords para la unión de todas las claves, o pokewiki keywords -w <wiki> para ver las claves de una wiki con sus nombres de categoría nativos. Para cualquier cosa fuera de este vocabulario, usa search.

Un patrón práctico: consultas en varios pasos

Las preguntas reales a menudo encadenan los comandos — y encadenar es también cómo evitas responder desde la memoria obsoleta. Para encontrar un contraataque a una amenaza dentro del roster disponible de un juego específico:

1. search el nombre de la amenaza para confirmar que tienes la página correcta.
2. page para leer sus tipos, estadísticas y habilidades reales — no lo que recuerdas.
3. page el artículo del roster/regulación del juego para ver qué está realmente disponible (este es el paso que detecta "asumí que X estaba en este juego").
4. filter por el tipo relevante dentro de ese grupo para enumerar opciones reales.

Cada paso reemplaza una suposición con un dato de la wiki. Cuando una consulta contradiga lo que estabas a punto de decir, confía en la consulta.

Cumplimiento (no lo evites)

Esta herramienta es deliberadamente respetuosa con las wikis, y eso es una característica. Solo usa la API de MediaWiki (nunca scraping), serializa y limita la tasa de solicitudes, cachea durante 24h, y envía un User-Agent identificativo. No intentes paralelizarla, evitar el caché en un bucle, ni añadir las wikis japonesa/francesa/italiana (excluidas porque bloquean el acceso automatizado). Si una solicitud es limitada (código de salida 4), espera y reintenta una vez — no insistas.

Referencias

• references/cli.md — cada comando, argumento, bandera, formato de salida y código de salida.