Eagle API Skill
Control the local Eagle application through CLI commands. Eagle is a digital asset management tool for organizing images, videos, fonts, and design files.
Prerequisites
- - Eagle application must be running
- Eagle MCP plugin must be enabled (provides the local API server on port 41596)
CLI Usage
The CLI script is located at scripts/eagle-api-cli.js relative to this skill directory.
CODEBLOCK0
Array and object values are auto-parsed from JSON:
CODEBLOCK1
Tool Categories
Choose the relevant reference file for detailed tool documentation:
- - App — Get Eagle app info (version, platform, locale). See references/app-tools.md
- Item — Search, filter, add, update, tag, and organize library items. See references/item-tools.md
- Folder — Create, query, and update folder hierarchy. See references/folder-tools.md
- Tag — Query, count, rename, and merge tags. See references/tag-tools.md
- Tag Group — Manage tag groups and tag associations. See references/tag-group-tools.md
- AI Search — Semantic search by text or similar items (requires AI Search plugin). See references/ai-search-tools.md
Common Workflows
Search for items
CODEBLOCK2
Organize items
CODEBLOCK3
Tag management
CODEBLOCK4
Eagle API 技能
通过 CLI 命令控制本地 Eagle 应用程序。Eagle 是一款用于整理图片、视频、字体和设计文件的数字资产管理工具。
前置条件
- - 必须运行 Eagle 应用程序
- 必须启用 Eagle MCP 插件（在端口 41596 上提供本地 API 服务器）
CLI 使用方法
CLI 脚本位于此技能目录下的 scripts/eagle-api-cli.js。
bash
使用 JSON 参数调用工具
node scripts/eagle-api-cli.js call <工具名称> --json {key: value}
使用单个参数调用工具
node scripts/eagle-api-cli.js call <工具名称> --param1 value1 --param2 value2
列出所有可用工具
node scripts/eagle-api-cli.js list
获取特定工具的帮助信息
node scripts/eagle-api-cli.js help <工具名称>
数组和对象值会自动从 JSON 解析：
bash
node scripts/eagle-api-cli.js call item_get --tags [photo,landscape] --limit 10
工具分类
选择相关的参考文件以获取详细的工具文档：
常见工作流程
搜索项目
bash
文本搜索
node scripts/eagle-api-cli.js call item_query --query 日落风景
按标签和扩展名筛选
node scripts/eagle-api-cli.js call item_get --tags [photo] --ext jpg --limit 20
获取 Eagle 中选中的项目
node scripts/eagle-api-cli.js call item
getselected
整理项目
bash
为项目添加标签
node scripts/eagle-api-cli.js call item
addtags --json {ids: [item1, item2], tags: [已审核, 已批准]}
将项目移动到文件夹
node scripts/eagle-api-cli.js call item
addto
folders --json {ids: [item1], folders: [folderid]}
创建新文件夹
node scripts/eagle-api-cli.js call folder_create --json {folders: [{name: 我的文件夹, iconColor: blue}]}
标签管理
bash
列出所有标签
node scripts/eagle-api-cli.js call tag_get
合并重复标签
node scripts/eagle-api-cli.js call tag_merge --json {sourceTags: [photo, photograph], targetTag: photo}
