← 返回 Skills 市场
lulu-trans

使用欧路词典OpenAPI,对生词本及笔记进行查询、修改等操作。

作者 lulu-trans · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ⚠ suspicious
303
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install eudic-openapi-skills
功能描述
通过欧路词典OpenAPI管理生词本和笔记,实现查询、添加、修改、删除及语音评分功能。
使用说明 (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

  1. 访问 https://my.eudic.net/OpenAPI/Authorization 获取 API Token\r
  2. 格式: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
安全使用建议
要不要安装/启用这个技能前请考虑: - 技能需要你的欧路词典 OpenAPI Token(格式为 'NIS {token}');授予后技能可以读取、添加、修改和删除你的生词本、笔记和语料。仅在你信任技能来源并愿意让其管理这些数据时才提供。 - 元数据未声明需要凭据且没有主页/来源信息,这降低了可审计性;最好只在知道并信任作者或源码的情况下继续。 - 如果可能,避免把长期有效的全权限 token 存在全局环境或让技能长期自动使用;优先在会话中一次性输入并在用毕后撤销/重置 token。 - 考虑要求技能仅在用户明确确认后才执行有写入/删除动作(关闭自动调用或在代理设置中限制自动化权限)。 - 若不确定来源,可选择不安装或联系技能发布者索取源码/主页以进一步审查。
功能分析
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.
能力评估
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 并允许自动调用,代理可能在未经额外确认的情况下对用户账户进行读写操作。
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install eudic-openapi-skills
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /eudic-openapi-skills 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.1
- 新增对用户语料的查询和筛选功能,包括按最近N天或是否已收藏筛选语料 - 支持批量查询用户语料单词详情 - 更新功能说明,覆盖“查询我的语料”等新场景 - 略去语音评分相关描述 - 说明文档增强,反映新增API能力
v1.0.0
使用欧路词典OpenAPI,对生词本及笔记进行查询、修改等操作。
元数据
Slug eudic-openapi-skills
版本 1.0.1
许可证 MIT-0
累计安装 1
当前安装数 0
历史版本数 2
常见问题

使用欧路词典OpenAPI,对生词本及笔记进行查询、修改等操作。 是什么?

通过欧路词典OpenAPI管理生词本和笔记,实现查询、添加、修改、删除及语音评分功能。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 303 次。

如何安装 使用欧路词典OpenAPI,对生词本及笔记进行查询、修改等操作。?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install eudic-openapi-skills」即可一键安装,无需额外配置。

使用欧路词典OpenAPI,对生词本及笔记进行查询、修改等操作。 是免费的吗?

是的,使用欧路词典OpenAPI,对生词本及笔记进行查询、修改等操作。 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

使用欧路词典OpenAPI,对生词本及笔记进行查询、修改等操作。 支持哪些平台?

使用欧路词典OpenAPI,对生词本及笔记进行查询、修改等操作。 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 使用欧路词典OpenAPI,对生词本及笔记进行查询、修改等操作。?

由 lulu-trans(@lulu-trans)开发并维护,当前版本 v1.0.1。

💬 留言讨论