jpdb-frequency-lookup

Query the JPDB API to enrich word lists with frequency ranks.

Updated Mar 19, 2026
One-click install
npx skills add https://github.com/mrohrssen/Koto2 --skill jpdb-frequency-lookup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: jpdb-frequency-lookup
Source: https://github.com/mrohrssen/Koto2/tree/main/.claude/plugins/koto-forge/1.1.0/skills/jpdb-frequency-lookup
Command: npx skills add https://github.com/mrohrssen/Koto2 --skill jpdb-frequency-lookup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enrich Japanese word lists or CSV data with up-to-date JPDB frequency ranks to improve vocabulary prioritization and data quality.

Core Features & Use Cases

  • Look up frequency ranks for words via the JPDB API and attach frequency data to your dataset.
  • Handle parsing of words to vid/sid, batch requests, and retry logic for compounds and edge cases.
  • Use cases: enhancing flashcard decks, ranking study items by frequency, enriching CSV exports with frequency info.

Quick Start

Run the enrichment script with your JPDB API key to process your CSV file and write back enriched data.

Frequently Asked Questions about jpdb-frequency-lookup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add JPDB frequency ranks to a Japanese vocabulary CSV file?

The Skill enriches flashcard decks and study items by querying the JPDB API to attach frequency ranks to your vocabulary lists. This allows you to rank study items by how often words appear, optimizing your learning prioritization.

Do I need an API key to look up word frequency data with JPDB?

Yes, you need a JPDB API key to process word lists and retrieve frequency ranks. Set the JPDB_API_KEY environment variable before executing the script to authenticate batch requests and fetch data for your vocabulary items.

How does the enrichment script handle compound words and parsing errors?

The script processes compound words by stripping them down to their root forms during parsing. It applies batch processing and retry logic to handle edge cases, ensuring robust frequency data enrichment for complex vocabulary entries.

Can I batch process a large CSV dataset to enrich it with frequency info?

Yes, the script supports batch processing of CSV datasets to enrich them with frequency info. It handles batch requests to the JPDB API and applies robust parsing to ensure your vocabulary lists are updated efficiently.

What's the best way to prioritize Japanese study decks using frequency data?

The best way to prioritize study decks is to attach JPDB frequency ranks to your vocabulary items. By enriching your flashcard decks with this data, you can rank study items by occurrence frequency to focus on the most common words.

Why does my JPDB frequency lookup fail on certain vocabulary list items?

Frequency lookup failures on certain items usually stem from compound words or parsing edge cases. The script includes compound stripping and retry logic to handle these issues, but some complex root-word forms may still fail to resolve correctly.