Eagle Skill

该 Skill 提供 Node CLI 脚本，经本地 API 服务器控制 Eagle 应用，可搜索与筛选素材、增删标签、移动条目到文件夹、创建和更新文件夹、管理标签组，并支持需额外插件的语义搜索；使用前需自行确保 Eagle 及其插件正在运行。

roaycl

热度 54.57

最近更新 2026-05-11 17:35:38

分类：效率依赖：代码执行 / 第三方 API应用场景：工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add eagle-skill

Metadata

name: eagle
description: Control Eagle application for digital asset management - search, organize, tag items, manage folders and tag groups. Use when user wants to interact with their Eagle library, search for images, manage tags or folders.
allowed-tools: Bash(node *)

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.

# Call a tool with JSON parameters
node scripts/eagle-api-cli.js call <tool_name> --json '{"key": "value"}'

# Call a tool with individual parameters
node scripts/eagle-api-cli.js call <tool_name> --param1 value1 --param2 value2

# List all available tools
node scripts/eagle-api-cli.js list

# Get help for a specific tool
node scripts/eagle-api-cli.js help <tool_name>

Array and object values are auto-parsed from JSON:

node scripts/eagle-api-cli.js call item_get --tags '["photo","landscape"]' --limit 10

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

# Text search
node scripts/eagle-api-cli.js call item_query --query "sunset landscape"

# Filter by tags and extension
node scripts/eagle-api-cli.js call item_get --tags '["photo"]' --ext "jpg" --limit 20

# Get selected items in Eagle
node scripts/eagle-api-cli.js call item_get_selected

Organize items

# Add tags to items
node scripts/eagle-api-cli.js call item_add_tags --json '{"ids": ["item1", "item2"], "tags": ["reviewed", "approved"]}'

# Move items to folders
node scripts/eagle-api-cli.js call item_add_to_folders --json '{"ids": ["item1"], "folders": ["folder_id"]}'

# Create a new folder
node scripts/eagle-api-cli.js call folder_create --json '{"folders": [{"name": "My Folder", "iconColor": "blue"}]}'

Tag management

# List all tags
node scripts/eagle-api-cli.js call tag_get

# Merge duplicate tags
node scripts/eagle-api-cli.js call tag_merge --json '{"sourceTags": ["photo", "photograph"], "targetTag": "photo"}'