Community라이팅 & 에디팅github.com

AirswitchAsa/pokemon-wikis-cli

4개의 포켓몬 위키(Bulbapedia, 52poke, PokéWiki, WikiDex)를 하나의 영어 CLI로 준수하게 접근할 수 있는 CLI 우선의 완전 비동기 SDK입니다.

pokemon-wikis-cli란 무엇인가요?

pokemon-wikis-cli은 개발자와 AI 에이전트가 4개의 주요 포켓몬 위키(Bulbapedia - 영어, 52poke - 중국어, PokéWiki - 독일어, WikiDex - 스페인어)를 단일 영어 명령줄 인터페이스(pokewiki)로 조회할 수 있게 해주는 비공식 도구입니다. 모든 검색은 반드시 `-w` 플래그로 위키를 선택해야 하며, `search`, `page`, `filter`, `keywords`의 네 가지 명령을 제공합니다. `search`는 퍼지 전체 텍스트 검색, `page`는 정확한 제목의 위키텍스트(raw wikitext) 조회, `filter`는 타입/세대/알 그룹/지역/특성 등의 교차 조건을 만족하는 모든 포켓몬 열거, `keywords`는 filter에 사용 가능한 제약 키를 확인합니다. 이 도구는 MediaWiki API만 사용하며 스크래핑을 하지 않고, 요청을 직렬화 및 속도 제한하며, 24시간 캐싱을 적용하고 식별 가능한 User-Agent를 전송함으로써 각 위키의 이용 약관을 엄격히 준수합니다. AI 에이전트는 포켓몬의 타입/스탯/특성, 기술 효과, 타입 상성, 진화 라인, 특정 게임의 사용 가능 로스터 등 사실적인 질문에 대해 기억에 의존하지 말고 이 도구로 위키를 직접 조회해야 정확도를 높일 수 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add AirswitchAsa/pokemon-wikis-cli

Installed? Explore more 라이팅 & 에디팅 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

pokewiki

네 개의 포켓몬 위키 — Bulbapedia (영어), 神奇宝贝百科 / 52poke (중국어), PokéWiki (독일어), WikiDex (스페인어) — 를 하나의 영어 CLI pokewiki로 조회합니다.

pokemon-wikis-cli은 비공식 독립 도구이며, 이들 위키나 The Pokémon Company와 제휴 또는 보증 관계가 아닙니다.

이 스킬을 사용해야 할 때

포켓몬에 관한 사실적인 질문(종의 타입/스탯/특성, 기술의 효과, 타입 상성, 진화 라인, 특정 특성을 공유하는 포켓몬, 또는 특정 게임의 사용 가능 로스터, 지역 도감, 현 경쟁 규정 등)에 사용하세요.

위키를 진실의 원천으로 삼고, 자신의 기억에 의존하지 마십시오. 포켓몬 정보는 방대하고 버전별로 나뉘며 자주 업데이트됩니다. 로스터는 규정에 따라 바뀌고, 이름은 언어마다 다르며, 당신이 기억하는 "사실"이 잘못된 게임에서 온 것일 수도 있고 단순히 틀렸을 수도 있습니다. 정확성이 중요할 때는 답변 전에 반드시 조회하세요. 한 번 조회하는 비용은 명령 하나지만, 잘못된 타입, 스탯, 또는 "이 포켓몬은 이 게임에 있습니다"라고 자신 있게 말했다가 사용자가 오류를 잡아내는 비용은 훨씬 큽니다.

CLI 설치

번들 스크립트로 명령어를 확인합니다(이 SKILL.md 기준 상대 경로). 사용할 명령어를 출력하거나, 설치 안내와 함께 0이 아닌 코드로 종료합니다:

scripts/ensure-pokewiki.sh

순서대로 다음을 확인합니다: PATH에 이미 있는 pokewiki, 그 다음 uvx (GitHub에서 바로 실행 — 설치 불필요; uv는 첫 사용 후 빌드를 캐시합니다). 둘 다 없으면 설치 옵션을 출력하고 1로 종료합니다 — 직접 설치하지 마십시오; 옵션을 사용자에게 보여주고 선택하게 하세요.

아래 예제는 모두 pokewiki를 사용합니다. 스크립트가 출력하는 값으로 대체하세요.

위키 선택: -w는 필수

모든 조회는 -w / --wiki로 선택한 정확히 하나의 위키에서 실행됩니다:

-w위키사용처
enBulbapedia가장 광범위한 영어 정보; 영어 기본값
zh-hans52poke (神奇宝贝百科)중국어 질의; 간체 출력
zh-hant52poke중국어 질의; 번체 출력
dePokéWiki독일어; CirrusSearch 없음 — 일반 search는 동작하지만 search -c는 안 됨; filter 사용
esWikiDex스페인어

위키를 사용자의 언어 또는 정보가 있는 위키에 맞추세요. 페이지 제목은 위키마다 다르며 번역되지 않습니다 — en에서는 Pikachu, zh-hans에서는 皮卡丘.

네 가지 명령

명령사용 시점
search <query>페이지를 찾아야 하거나 정확한 제목을 모를 때 (퍼지, 전체 텍스트)
filter <keys…>특성(타입, 세대, 알 그룹, 지역, 능력)의 교집합에 해당하는 모든 포켓몬을 원할 때
page <title>페이지(또는 리다이렉트되는 이름)를 알고 있으며 원시 위키텍스트(스탯, 타입, 특성, 기술)를 원할 때
keywords [axis]filter에 사용 가능한 제약 키를 확인할 때
pokewiki search "皮卡丘" -w zh-hans              # 퍼지 이름으로 페이지 찾기
pokewiki page "Garchomp" -w en                   # 원시 위키텍스트 (리다이렉트 따라감)
pokewiki filter type:dragon region:hisui -w en   # Hisui 도감의 모든 드래곤 타입
pokewiki keywords region -w en                   # Bulbapedia의 유효한 region: 키

구조화된 출력을 원하면 --format json을 추가하세요. 생략하면 직접 읽을 수 있는 결과가 출력됩니다. 모든 플래그와 종료 코드는 references/cli.md를 참조하세요.

명령 선택 가이드

  • 정확한 주제를 알고 있음 (이름이 알려진 포켓몬, 기술, 특성) → page. 리다이렉트를 따라가므로 보통 이름만으로 문서에 도달합니다.
  • 올바른 페이지를 찾고 있거나 제목이 확실하지 않음 → search. 그런 다음 최적 결과를 page로 읽으세요.
  • 특성으로 열거 ("모든 전기 1세대", "물/땅 타입") → filter. 키는 AND 교집합으로 결합되며, 공백 또는 쉼표로 구분하여 전달합니다.
  • 텍스트 검색을 특성으로 좁히기 → search "<text>" -c type:electric (CirrusSearch 위키만 해당 — de 제외).

filter용 제약 어휘

키는 영어이며 각 위키의 고유 분류로 해석됩니다. 두 가지 종류:

  • 범용 (모든 위키에서 동일): type: (18개), gen: (1–9), egg: (14개 알 그룹).
  • 위키별 (해당 위키가 분류하는 경우에만): region:은 en에서 9개, zh에서 10개; ability:는 zh에서만 312개. 지원하지 않는 위키에서 사용하면 명확한 오류 메시지와 함께 지원하는 위키 이름을 알려줍니다.

pokewiki keywords로 모든 키의 합집합을 보거나, pokewiki keywords -w <wiki>로 특정 위키의 키와 고유 분류 이름을 확인하세요. 이 어휘를 벗어나는 것은 search를 사용하세요.

실제 활용 패턴: 다단계 조회

실제 질문은 종종 명령을 연쇄적으로 사용합니다 — 그리고 연쇄는 오래된 기억으로 답변하는 것을 피하는 방법이기도 합니다. 특정 게임의 사용 가능 로스터 내에서 상대에 대응할 포켓몬을 찾으려면:

  1. search로 상대 이름을 확인하여 올바른 페이지인지 확인합니다.
  2. page로 실제 타입, 스탯, 특성을 읽습니다 — 기억에 의존하지 마세요.
  3. 게임의 로스터/규정 문서를 page로 조회하여 실제로 사용 가능한 것을 확인합니다 (이 단계가 "나는 X가 이 게임에 있다고 가정했다"를 잡아냅니다).
  4. 해당 풀 내에서 관련 타입으로 filter하여 실제 옵션을 열거합니다.

각 단계는 가정을 위키의 사실로 대체합니다. 조회 결과가 당신이 말하려던 것과 모순된다면, 조회를 신뢰하세요.

준수 사항 (우회 금지)

이 도구는 의도적으로 위키에 예의를 갖추며, 이것이 기능입니다. MediaWiki API만 사용하며(스크래핑 없음), 요청을 직렬화하고 속도 제한을 적용하며, 24시간 캐싱하고, 식별 가능한 User-Agent를 전송합니다. 병렬화, 루프에서 캐시 우회, 또는 일본어/프랑스어/이탈리아어 위키 추가(자동 접근을 차단하므로 제외됨)를 시도하지 마십시오. 요청이 제한되면(종료 코드 4), 기다렸다가 한 번만 재시도하세요 — 반복해서 요청하지 마십시오.

참고 자료

  • references/cli.md — 모든 명령, 인수, 플래그, 출력 형식 및 종료 코드.

관련 스킬