← Back to Skills Marketplace
使用欧路词典OpenAPI，对生词本及笔记进行查询、修改等操作。
by
lulu-trans
· GitHub ↗
· v1.0.1
· MIT-0
303
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install eudic-openapi-skills
Description
通过欧路词典OpenAPI管理生词本和笔记，实现查询、添加、修改、删除及语音评分功能。
README (SKILL.md)
欧路词典/法语助手/德语助手/西语助手 (Eudic OpenAPI)\r
\r 本技能提供 欧路词典/法语助手/德语助手/西语助手OpenAPI 的调用能力，用于管理生词本、用户语料、笔记和语音评分等功能。\r \r
何时使用 (触发条件)\r
\r 当用户提出以下类型的请求时，应使用本技能：\r \r
- "查看我的生词本"\r
- "添加单词到生词本"\r
- "查询某个单词"\r
- "查询我的语料"\r
- "按最近N天或是否已收藏筛选语料"\r
- "批量查询语料单词详情"\r
- "添加笔记"\r
- "查看笔记"\r
- "删除生词本/单词/笔记"\r \r
环境配置\r
\r
获取 API Token\r
\r
- 访问 https://my.eudic.net/OpenAPI/Authorization 获取 API Token\r
- 格式：
NIS {token}\r \r
支持的语言与应用名称\r
\r
| 语言 | language 参数 | 应用名称 |\r
|------|--------------|----------|\r
| 英语 | en | 欧路词典 |\r
| 法语 | fr | 法语助手 |\r
| 德语 | de | 德语助手 |\r
| 西班牙语 | es | 西语助手 |\r
\r
注意: 调用 API 时需要通过 language query 参数指定语言。\r
\r
---\r
\r
核心功能与用法\r
\r
1. 获取所有生词本\r
\r
# language: en=欧路词典, fr=法语助手, de=德语助手, es=西语助手\r
curl -s "https://api.frdic.com/api/open/v1/studylist/category?language=en" \\r
-H "Authorization: NIS {Token}"\r
```\r
\r
**参数**: \r
- `language`: en/fr/de/es (必填)\r
\r
**返回**: 生词本列表 (id, language, name, add_time)\r
\r
---\r
\r
### 2. 添加新生词本\r
\r
```bash\r
curl -s -X POST "https://api.frdic.com/api/open/v1/studylist/category" \\r
-H "Authorization: NIS {Token}" \\r
-H "Content-Type: application/json" \\r
-d '{"language": "en", "name": "新单词本"}'\r
```\r
\r
**参数**:\r
- `language`: en/fr/de/es (必填)\r
- `name`: 生词本名称 (必填)\r
\r
---\r
\r
### 3. 重命名生词本\r
\r
```bash\r
curl -s -X PATCH "https://api.frdic.com/api/open/v1/studylist/category" \\r
-H "Authorization: NIS {Token}" \\r
-H "Content-Type: application/json" \\r
-d '{"id": "生词本ID", "language": "en", "name": "新名称"}'\r
```\r
\r
**参数**:\r
- `id`: 生词本ID (必填)\r
- `language`: en/fr/de/es (必填)\r
- `name`: 新名称 (必填)\r
\r
---\r
\r
### 4. 删除生词本\r
\r
```bash\r
curl -s -X DELETE "https://api.frdic.com/api/open/v1/studylist/category" \\r
-H "Authorization: NIS {Token}" \\r
-H "Content-Type: application/json" \\r
-d '{"id": "生词本ID", "language": "en", "name": "生词本名称"}'\r
```\r
\r
---\r
\r
### 5. 获取生词本单词\r
\r
```bash\r
curl -s "https://api.frdic.com/api/open/v1/studylist/words?language=en&category_id=0&page=1&page_size=100" \\r
-H "Authorization: NIS {Token}"\r
```\r
\r
**参数**:\r
- `language`: en/fr/de/es (必填)\r
- `category_id`: 生词本ID (必填)\r
- `page`: 页码 (可选，默认1)\r
- `page_size`: 每页数量 (可选，默认100)\r
\r
**返回**: 单词列表 (word, phon, exp, add_time, star, context_line)\r
\r
---\r
\r
### 6. 批量添加单词\r
\r
```bash\r
curl -s -X POST "https://api.frdic.com/api/open/v1/studylist/words" \\r
-H "Authorization: NIS {Token}" \\r
-H "Content-Type: application/json" \\r
-d '{"language": "en", "category_id": "0", "words": ["apple", "banana", "orange"]}'\r
```\r
\r
**参数**:\r
- `language`: en/fr/de/es (必填)\r
- `category_id`: 生词本ID (必填)\r
- `words`: 单词数组 (必填)\r
\r
---\r
\r
### 7. 删除单词\r
\r
```bash\r
curl -s -X DELETE "https://api.frdic.com/api/open/v1/studylist/words" \\r
-H "Authorization: NIS {Token}" \\r
-H "Content-Type: application/json" \\r
-d '{"language": "en", "category_id": "0", "words": ["apple"]}'\r
```\r
\r
---\r
\r
### 8. 新增单个单词\r
\r
```bash\r
curl -s -X POST "https://api.frdic.com/api/open/v1/studylist/word" \\r
-H "Authorization: NIS {Token}" \\r
-H "Content-Type: application/json" \\r
-d '{"language": "en", "word": "hello", "star": 2, "context_line": "Hello, how are you?"}'\r
```\r
\r
**参数**:\r
- `language`: en/fr/de/es (必填)\r
- `word`: 单词 (必填)\r
- `star`: 星级 1-5 (可选)\r
- `context_line`: 语境例句 (可选)\r
- `category_ids`: 分组ID列表 (可选)\r
\r
---\r
\r
### 9. 查询单词\r
\r
```bash\r
curl -s "https://api.frdic.com/api/open/v1/studylist/word?language=en&word=hello" \\r
-H "Authorization: NIS {Token}"\r
```\r
\r
**参数**:\r
- `language`: en/fr/de/es (必填)\r
- `word`: 单词 (必填)\r
\r
**返回**: 单词详情\r
\r
---\r
\r
### 10. 获取笔记列表\r
\r
```bash\r
curl -s "https://api.frdic.com/api/open/v1/studylist/notes?page=0&page_size=100" \\r
-H "Authorization: NIS {Token}"\r
```\r
\r
**参数**:\r
- `page`: 页码 (可选，默认0)\r
- `page_size`: 每页数量 (可选，默认100)\r
\r
**返回**: 笔记列表 (word, note, language, add_time)\r
\r
---\r
\r
### 11. 查询用户语料列表\r
\r
```bash\r
curl -s "https://api.frdic.com/api/open/v1/studylist/vocab_entries?language=en&recent_days=30&is_favorited=true&page=0&page_size=20" \\r
-H "Authorization: NIS {Token}"\r
```\r
\r
**参数**:\r
- `language`: en/fr/de/es (必填)\r
- `recent_days`: 最近N天 (可选，小于等于0表示不筛选)\r
- `is_favorited`: 是否已收藏到生词本 (可选，`true` 只看已收藏，`false` 只看未收藏)\r
- `page`: 页码 (可选，默认 `-1`；`-1` 表示不分页)\r
- `page_size`: 每页数量 (可选，默认100；仅在 `page >= 0` 时生效)\r
\r
**返回**: 语料列表 (word, exp, add_time, rating, contexts)\r
\r
---\r
\r
### 12. 批量查询用户语料单词详情\r
\r
```bash\r
curl -s -X POST "https://api.frdic.com/api/open/v1/studylist/vocab_words" \\r
-H "Authorization: NIS {Token}" \\r
-H "Content-Type: application/json" \\r
-d '{"language": "en", "words": ["action", "amplify"]}'\r
```\r
\r
**参数**:\r
- `language`: en/fr/de/es (必填)\r
- `words`: 单词数组 (必填，会自动忽略空白并去重)\r
\r
**返回**: 单词详情列表 (word, exp, contexts)\r
\r
---\r
\r
### 13. 获取单个单词笔记\r
\r
```bash\r
curl -s "https://api.frdic.com/api/open/v1/studylist/note?word=hello" \\r
-H "Authorization: NIS {Token}"\r
```\r
\r
**参数**:\r
- `word`: 单词 (必填)\r
\r
**返回**:单词笔记不存在会返回404.存在会返回单词内容\r
---\r
\r
### 14. 新增笔记\r
\r
```bash\r
curl -s -X POST "https://api.frdic.com/api/open/v1/studylist/note" \\r
-H "Authorization: NIS {Token}" \\r
-H "Content-Type: application/json" \\r
-d '{"word": "hello", "note": "这是笔记内容"}'\r
```\r
\r
**参数**:\r
- `word`: 单词 (必填)\r
- `note`: 笔记内容 (必填)\r
\r
---\r
\r
### 15. 删除笔记\r
\r
```bash\r
curl -s -X DELETE "https://api.frdic.com/api/open/v1/studylist/note" \\r
-H "Authorization: NIS {Token}" \\r
-H "Content-Type: application/json" \\r
-d '{"word": "hello"}'\r
```\r
\r
---\r
\r
## 响应码\r
\r
| 响应码 | 含义 |\r
|--------|------|\r
| 200 | 成功 (GET) |\r
| 201 | 创建/修改成功 (POST/PATCH) |\r
| 204 | 删除成功 (DELETE) |\r
| 400 | 参数错误 |\r
| 401 | 授权认证失败 |\r
| 403 | 访问过于频繁 |\r
\r
## 流量限制\r
\r
| 周期 | 限制次数 | 封停时间 |\r
|------|----------|----------|\r
| 1分钟 | 30次 | 1小时 |\r
| 30分钟 | 500次 | 24小时 |\r
Usage Guidance
要不要安装/启用这个技能前请考虑：
- 技能需要你的欧路词典 OpenAPI Token（格式为 'NIS {token}'）；授予后技能可以读取、添加、修改和删除你的生词本、笔记和语料。仅在你信任技能来源并愿意让其管理这些数据时才提供。
- 元数据未声明需要凭据且没有主页/来源信息，这降低了可审计性；最好只在知道并信任作者或源码的情况下继续。
- 如果可能，避免把长期有效的全权限 token 存在全局环境或让技能长期自动使用；优先在会话中一次性输入并在用毕后撤销/重置 token。
- 考虑要求技能仅在用户明确确认后才执行有写入/删除动作（关闭自动调用或在代理设置中限制自动化权限）。
- 若不确定来源，可选择不安装或联系技能发布者索取源码/主页以进一步审查。
Capability Analysis
Type: OpenClaw Skill
Name: eudic-openapi-skills
Version: 1.0.1
The skill bundle is a legitimate API wrapper for the Eudic (欧路词典) OpenAPI, providing functionality to manage vocabulary lists, notes, and language corpora. All documented endpoints point to the official domain (api.frdic.com), and the instructions in SKILL.md are consistent with the stated purpose without any signs of malicious intent or prompt injection.
Capability Assessment
Purpose & Capability
SKILL.md 的接口列表、HTTP 方法与参数与‘管理生词本/笔记/语料’的描述一致——列出了查询、添加、修改、删除及语音评分等 API 调用。问题是元数据中未声明任何凭据或 primary credential，但文档明确要求使用 'Authorization: NIS {Token}'。此外 Skill 源与主页未知，降低可审计性。
Instruction Scope
运行时指令只描述对 https://api.frdic.com 的 curl 调用并使用 Authorization 头，未要求读取本地文件或访问其他第三方端点。指令包含有破坏性操作（DELETE、PATCH 等），这与技能目的相符但意味着一旦有有效 token，技能能修改或删除用户数据。
Install Mechanism
这是纯文本指令型技能（无安装脚本、无代码文件、无外部下载），因此没有写磁盘或执行远程安装的风险。
Credentials
SKILL.md 明确需要用户的 OpenAPI Token ('NIS {Token}')，但技能声明中没有要求任何环境变量或列出 primary credential —— 这是不一致且容易导致用户在运行时以不安全方式提供凭据。该 token 可用于读取和修改/删除生词本与笔记，权限范围较大，应当明确并最小化所需权限。
Persistence & Privilege
技能未设置 always:true（正常），但默认允许模型自动调用。结合技能会使用用户 API token 的事实，这意味着若授予 token 并允许自动调用，代理可能在未经额外确认的情况下对用户账户进行读写操作。
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install eudic-openapi-skills - After installation, invoke the skill by name or use
/eudic-openapi-skills - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- 新增对用户语料的查询和筛选功能，包括按最近N天或是否已收藏筛选语料
- 支持批量查询用户语料单词详情
- 更新功能说明，覆盖“查询我的语料”等新场景
- 略去语音评分相关描述
- 说明文档增强，反映新增API能力
v1.0.0
使用欧路词典OpenAPI，对生词本及笔记进行查询、修改等操作。
Metadata
Frequently Asked Questions
What is 使用欧路词典OpenAPI，对生词本及笔记进行查询、修改等操作。?
通过欧路词典OpenAPI管理生词本和笔记，实现查询、添加、修改、删除及语音评分功能。 It is an AI Agent Skill for Claude Code / OpenClaw, with 303 downloads so far.
How do I install 使用欧路词典OpenAPI，对生词本及笔记进行查询、修改等操作。?
Run "/install eudic-openapi-skills" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is 使用欧路词典OpenAPI，对生词本及笔记进行查询、修改等操作。 free?
Yes, 使用欧路词典OpenAPI，对生词本及笔记进行查询、修改等操作。 is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does 使用欧路词典OpenAPI，对生词本及笔记进行查询、修改等操作。 support?
使用欧路词典OpenAPI，对生词本及笔记进行查询、修改等操作。 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created 使用欧路词典OpenAPI，对生词本及笔记进行查询、修改等操作。?
It is built and maintained by lulu-trans (@lulu-trans); the current version is v1.0.1.
More Skills