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
CODEBLOCK0
Commands
| Action | Command |
|---|
| All characters | INLINECODE0 |
| Students only |
harrypotter students [limit] |
| Staff only |
harrypotter staff [limit] |
| By house |
harrypotter house <name> |
| Spells |
harrypotter spells [limit] |
| Search |
harrypotter search <query> |
Examples
CODEBLOCK1
Output
Character output:
CODEBLOCK2
Search output (detailed):
CODEBLOCK3
Spell output:
CODEBLOCK4
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:
- 1. Run
./harrypotter search "name" for specific characters - Run
./harrypotter house <name> for house members - Run
./harrypotter spells for spell information - Run
./harrypotter students or ./harrypotter staff for 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.
哈利·波特查询工具
面向AI代理的CLI工具,用于搜索和查询哈利·波特宇宙信息,帮助人类用户解答疑问。斯莱特林里都有谁来着?——现在你的代理可以回答了。
使用HP-API(免费哈利·波特API)。无需账户或API密钥。
使用方法
哈利·波特的主要角色有哪些?
列出霍格沃茨的学生
格兰芬多学院都有谁?
哈利·波特中有哪些咒语?
搜索赫敏
命令
| 操作 | 命令 |
|---|
| 所有角色 | harrypotter characters [数量] |
| 仅学生 |
harrypotter students [数量] |
| 仅教职工 | harrypotter staff [数量] |
| 按学院 | harrypotter house <名称> |
| 咒语 | harrypotter spells [数量] |
| 搜索 | harrypotter search <查询> |
示例
bash
harrypotter characters 10 # 前10个角色
harrypotter students # 所有霍格沃茨学生
harrypotter staff # 所有霍格沃茨教职工
harrypotter house gryffindor # 格兰芬多成员
harrypotter house slytherin # 斯莱特林成员
harrypotter spells 15 # 前15个咒语
harrypotter search hermione # 按名称查找角色
输出
角色输出:
🧙 哈利·波特 — 格兰芬多,混血,守护神:牡鹿
🧙 赫敏·格兰杰 — 格兰芬多,麻瓜出身,守护神:水獭
🧙 德拉科·马尔福 — 斯莱特林,纯血
搜索输出(详细):
🧙 赫敏·格兰杰 — 格兰芬多,麻瓜出身,守护神:水獭
演员:艾玛·沃特森
魔杖:葡萄藤木,龙心弦,10.75英寸
出生日期:1979年9月19日
咒语输出:
✨ 除你武器 — 解除对手的武器
✨ 荧光闪烁 — 在魔杖尖端产生一小束光
✨ 阿瓦达索命 — 杀戮咒
备注
- - 使用HP-API(hp-api.onrender.com)
- 无需身份验证
- 学院:格兰芬多、斯莱特林、赫奇帕奇、拉文克劳
- 每次查询默认限制为20条结果
- 搜索不区分大小写
代理实现说明
脚本位置: {skill_folder}/harrypotter(scripts/harrypotter的包装器)
当用户询问哈利·波特相关信息时:
- 1. 运行 ./harrypotter search 名称 查找特定角色
- 运行 ./harrypotter house <名称> 查找学院成员
- 运行 ./harrypotter spells 获取咒语信息
- 运行 ./harrypotter students 或 ./harrypotter staff 获取按角色分类的列表
学院名称(不区分大小写):
- - gryffindor(格兰芬多)
- slytherin(斯莱特林)
- hufflepuff(赫奇帕奇)
- ravenclaw(拉文克劳)
不适用于: 非哈利·波特的奇幻内容、API中未包含的普通冷知识。