/install harrypotter
Harry Potter Lookup
CLI for AI agents to search and lookup Harry Potter universe info for their humans. "Who was in Slytherin again?" — now your agent can answer.
Uses HP-API (free Harry Potter API). No account or API key needed.
Usage
"Who are the main Harry Potter characters?"
"List the Hogwarts students"
"Who's in Gryffindor house?"
"What spells are in Harry Potter?"
"Search for Hermione"
Commands
| Action | Command |
|---|---|
| All characters | harrypotter characters [limit] |
| Students only | harrypotter students [limit] |
| Staff only | harrypotter staff [limit] |
| By house | harrypotter house \x3Cname> |
| Spells | harrypotter spells [limit] |
| Search | harrypotter search \x3Cquery> |
Examples
harrypotter characters 10 # First 10 characters
harrypotter students # All Hogwarts students
harrypotter staff # All Hogwarts staff
harrypotter house gryffindor # Gryffindor members
harrypotter house slytherin # Slytherin members
harrypotter spells 15 # First 15 spells
harrypotter search "hermione" # Find character by name
Output
Character output:
🧙 Harry Potter — Gryffindor, Half-blood, Patronus: Stag
🧙 Hermione Granger — Gryffindor, Muggleborn, Patronus: Otter
🧙 Draco Malfoy — Slytherin, Pure-blood
Search output (detailed):
🧙 Hermione Granger — Gryffindor, muggleborn, Patronus: otter
Actor: Emma Watson
Wand: vine, dragon heartstring, 10.75"
Born: 19-09-1979
Spell output:
✨ Expelliarmus — Disarms your opponent
✨ Lumos — Creates a small light at the wand's tip
✨ Avada Kedavra — The Killing Curse
Notes
- Uses HP-API (hp-api.onrender.com)
- No authentication required
- Houses: gryffindor, slytherin, hufflepuff, ravenclaw
- Default limit is 20 items per query
- Search is case-insensitive
Agent Implementation Notes
Script location: {skill_folder}/harrypotter (wrapper to scripts/harrypotter)
When user asks about Harry Potter:
- Run
./harrypotter search "name"for specific characters - Run
./harrypotter house \x3Cname>for house members - Run
./harrypotter spellsfor spell information - Run
./harrypotter studentsor./harrypotter stafffor role-based lists
House names (case-insensitive):
- gryffindor
- slytherin
- hufflepuff
- ravenclaw
Don't use for: Non-HP fantasy content, general trivia not in the API.
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install harrypotter - After installation, invoke the skill by name or use
/harrypotter - Provide required inputs per the skill's parameter spec and get structured output
What is Harrypotter?
CLI for AI agents to lookup Harry Potter universe info for their humans. Uses HP-API. No auth required. It is an AI Agent Skill for Claude Code / OpenClaw, with 1438 downloads so far.
How do I install Harrypotter?
Run "/install harrypotter" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Harrypotter free?
Yes, Harrypotter is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Harrypotter support?
Harrypotter is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Harrypotter?
It is built and maintained by jeffaf (@jeffaf); the current version is v1.0.0.