item-tools-cli

AIOP AI Capability Marketplace CLI — Discover, search, and install AI capabilities for your agents.

A unified entry point for AI agents (Codex, Claude Code, OpenClaw, Kiro, etc.) to discover and use capabilities from the AIOP platform.

Concept

Capability (统一入口)
├── Skill Package（可选）       — rich guidance, workflow, examples
├── REST Tool Definition（可选） — self-describing API with schema
└── MCP Server Config（可选）    — Model Context Protocol server

Agents don't need to know whether they need a Skill, REST Tool, or MCP Server upfront. They search for a Capability, and the platform returns what's available and how to use it.

Installation

npm install -g item-tools-cli

Quick Start

# 1. Configure authentication
aiop config set token sk_your_api_key_here

# 2. Search for capabilities
aiop search "web crawl"

# 3. Get detailed info
aiop info web-crawl

# 4. Install to your agent
aiop install web-crawl --agent claude

Authentication

All APIs require authentication. Two modes supported:

API Key (recommended)

aiop config set token sk_your_api_key_here

IAM Token

aiop config set authType iam
aiop config set token YOUR_IAM_JWT_TOKEN

Environment Variable (for CI/CD)

export AIOP_TOKEN=sk_your_api_key_here
aiop search "document"

Commands

aiop search <query>

Search capabilities by keyword or natural language.

aiop search "web crawl"                     # 语义搜索（默认）
aiop search "pdf" --mode keyword            # 关键字搜索
aiop search "face detection" -c "Face Recognition"  # 按分类过滤
aiop search "document" -n 20               # 返回更多结果
aiop search "weather" --json               # JSON 输出（供 Agent 消费）

Options: | Flag | Description | |------|-------------| | -m, --mode <mode> | Search mode: semantic (default) or keyword | | -c, --category <cat> | Filter by category | | -t, --type <type> | Filter by artifact type | | -n, --limit <n> | Max results (default: 10) | | --json | Machine-readable JSON output |

aiop list

List all available capabilities.

aiop list                          # 列出所有
aiop list --category "Document Processing"
aiop list --json                   # JSON 输出

aiop info <id>

Get detailed information about a capability.

aiop info web-crawl                # 查看详情
aiop info document-extract --skill # 显示 SKILL.md 内容
aiop info video-analysis --tools   # 显示 REST API 定义
aiop info web-crawl --mcp          # 显示 MCP Server 配置
aiop info web-crawl --json         # JSON 输出

aiop install <id>

Install a capability to your agent. This is the core command.

Install as Skill (default)

Downloads the Skill ZIP package and extracts to the agent's skills directory:

# Install to Claude Code (default agent)
aiop install web-crawl --agent claude
# → ~/.claude/skills/web-crawl/SKILL.md + references/

# Install to Codex CLI
aiop install web-crawl --agent codex
# → ~/.codex/skills/web-crawl/SKILL.md + references/

# Install to OpenClaw
aiop install web-crawl --agent openclaw
# → ~/.openclaw/skills/web-crawl/SKILL.md + references/

# Install to Kiro
aiop install web-crawl --agent kiro
# → ~/.kiro/skills/web-crawl/SKILL.md + references/

# Install to current project (instead of global)
aiop install web-crawl --agent claude --local
# → .claude/skills/web-crawl/

Install as MCP Server

Writes MCP server configuration to the agent's config file:

# Claude Code → writes to ~/.claude/settings.json
aiop install web-crawl --agent claude --type mcp_server

# Codex CLI → writes to ~/.codex/config.toml
aiop install web-crawl --agent codex --type mcp_server

# Kiro → writes to ~/.kiro/settings/mcp.json
aiop install web-crawl --agent kiro --type mcp_server

# OpenClaw → writes to ~/.openclaw/config.yaml
aiop install web-crawl --agent openclaw --type mcp_server

Install as REST Tool Definition

Saves the full API schema JSON for framework integration:

aiop install web-crawl --type rest_tool
# → .aiop/tools/web-crawl.json

Options

| Flag | Description | |------|-------------| | -a, --agent <agent> | Target agent: claude, codex, openclaw, kiro (default: claude) | | -t, --type <type> | Artifact type: skill (default), mcp_server, rest_tool | | -g, --global | Install to global agent config (default) | | --local | Install to current project directory | | -d, --dir <path> | Custom installation directory | | -f, --force | Overwrite existing files | | --json | Machine-readable output |

aiop config

Manage CLI configuration.

aiop config show                            # 查看当前配置
aiop config set baseUrl https://aiop-prod.item.com  # 设置 API 地址
aiop config set token sk_xxx                # 设置 token
aiop config reset                           # 重置为默认

Available config keys:

| Key | Description | Example | |-----|-------------|---------| | baseUrl | API server URL | https://aiop-prod.item.com | | token | Auth token (API Key or IAM JWT) | sk_e8c3f0... | | authType | Auth mode | api_key or iam | | installDir | Default skill install dir | ./my-skills |

Available Capabilities

| ID | Name | MCP | Skill | |----|------|-----|-------| | web-crawl | Web Crawling | ✓ | ✓ | | document-convert | Document Conversion | ✓ | ✓ | | document-extract | Document Extraction & OCR | ✓ | ✓ | | video-analysis | Video & Audio Analysis | ✓ | ✓ | | multi-source-search | Academic Search (arXiv, PubMed) | ✓ | ✓ | | geocode | Geocoding & Places | ✓ | ✓ | | route | Route Planning | ✓ | ✓ | | md-converter | Markdown Export | ✓ | ✓ | | excel-toolkit | Table Processing | ✓ | ✓ | | structured-extraction | Structured Info Extraction | ✓ | ✓ | | exchange-api | Currency Exchange Rates | ✓ | ✓ | | email | SMTP Email | ✓ | ✓ | | voice | Voice & Speech (TTS/STT) | — | ✓ |

Programmatic Usage

import { CapabilityService, InstallService } from 'item-tools-cli'

// Search
const service = new CapabilityService()
const results = await service.search({ query: 'document processing' })

// Install
const installer = new InstallService()
const result = await installer.install('web-crawl', {
  agent: 'claude',
  artifactType: 'skill',
})

Agent Integration Workflow

For Claude Code / Codex / OpenClaw Users

# Step 1: Install the CLI
npm install -g item-tools-cli

# Step 2: Set your API key
aiop config set token sk_your_key

# Step 3: Search what you need
aiop search "convert pdf to markdown"

# Step 4: Install the skill
aiop install document-convert --agent claude

# Step 5: (Optional) Also add MCP server for direct tool access
aiop install document-convert --agent claude --type mcp_server

# Done! Claude Code will now auto-detect the skill and MCP server.

For AI SDK / Framework Developers

# Get REST tool definitions for framework integration
aiop install document-convert --type rest_tool
# → .aiop/tools/document-convert.json (contains full API schema)

For CI/CD Pipelines

export AIOP_TOKEN=sk_your_key
export AIOP_API_URL=https://aiop-prod.item.com

# Install skills in CI
aiop install web-crawl --agent codex --json
aiop install document-extract --agent codex --json

API Endpoints (Platform-side)

| Endpoint | Method | Description | |----------|--------|-------------| | /aiop-tools/v1/tool/search | POST | Search capabilities (semantic + keyword) | | /aiop-tools/v1/capabilities/{id}/tools | GET | Get REST tool schema | | /aiop-tools/v1/capabilities/{id}/mcp/config | GET | Get MCP server config | | /aiop-tools/v1/capabilities/{id}/skill/manifest | GET | Get skill manifest | | /aiop-tools/v1/capabilities/{id}/skill/download | GET | Download skill ZIP package |

Environment Variables

| Variable | Description | |----------|-------------| | AIOP_API_URL | Override platform API URL | | AIOP_TOKEN | Override auth token (takes precedence over config) |

Troubleshooting

403 Forbidden — Token is missing or invalid. Run aiop config set token sk_xxx.

404 Not Found — The capability doesn't have the requested artifact type. Try a different --type.

Network error — Check aiop config show to verify the baseUrl is correct.

License

MIT