Claude Skills 是 Anthropic 的 2026 年打包格式，用于可重用代理功能。技能位于 ~/.claude/skills 中，并且可供每个 Claude Code 和 Claude Desktop 会话使用。本教程将逐步将 Scavio 打包为一项 Claude Skill，以便任何 Claude 会话都可以使用一个命令搜索网络、YouTube、亚马逊、沃尔玛和 Reddit。
前置条件
- 安装了 Claude Code 或 Claude Desktop
- Scavio API 密钥
- Node.js 20+
操作指南
步骤 1: 创建技能目录
技能位于 ~/.claude/skills/<name> 中。
Bash
mkdir -p ~/.claude/skills/scavio
cd ~/.claude/skills/scavio步骤 2: 编写技能清单
每个技能都需要一个 Skill.json 来描述命令和参数。
JSON
{
"name": "scavio",
"version": "1.0.0",
"description": "Real-time search across Google, YouTube, Amazon, Walmart, and Reddit via Scavio",
"entrypoint": "index.js",
"commands": [
{ "name": "search", "description": "Search the web", "params": {"query": "string"} },
{ "name": "amazon", "description": "Search Amazon products", "params": {"query": "string"} },
{ "name": "youtube_transcript", "description": "Get a YouTube transcript", "params": {"video_id": "string"} }
]
}步骤 3: 编写技能处理程序
入口点接收命令调用并调用 Scadio。
JavaScript
const API_KEY = process.env.SCAVIO_API_KEY;
export async function search({ query }) {
const r = await fetch('https://api.scavio.dev/api/v1/search', {
method: 'POST',
headers: { 'x-api-key': API_KEY, 'Content-Type': 'application/json' },
body: JSON.stringify({ query })
});
return r.json();
}
export async function amazon({ query }) {
const r = await fetch('https://api.scavio.dev/api/v1/search', {
method: 'POST',
headers: { 'x-api-key': API_KEY, 'Content-Type': 'application/json' },
body: JSON.stringify({ platform: 'amazon', query, marketplace: 'US' })
});
return r.json();
}步骤 4: 设置环境变量
将 SCAVIO_API_KEY 添加到您的 shell 配置文件中，以便每个 Claude 会话都会继承它。
Bash
echo 'export SCAVIO_API_KEY=sk_live_...' >> ~/.zshrc步骤 5: 使用克劳德代码中的技能
启动克劳德代码并调用技能。
Bash
# In Claude Code
> /skills scavio search "best AI framework 2026"Python 示例
Python
# Skills are JS-native, but you can call Scavio from Python to validate:
import os, requests
r = requests.post('https://api.scavio.dev/api/v1/search',
headers={'x-api-key': os.environ['SCAVIO_API_KEY']},
json={'query': 'best AI framework 2026'})
print(r.json()['organic_results'][:3])JavaScript 示例
JavaScript
// scavio skill handler
const API_KEY = process.env.SCAVIO_API_KEY;
export async function search({ query }) {
const r = await fetch('https://api.scavio.dev/api/v1/search', {
method: 'POST',
headers: { 'x-api-key': API_KEY, 'Content-Type': 'application/json' },
body: JSON.stringify({ query })
});
return r.json();
}预期输出
JSON
Running /skills scavio search in Claude Code returns structured Google results inline. Every Claude Code and Claude Desktop session now has one-command search without per-project setup.