Felo 搜索技能

适用场景

当用户提问涉及当前或实时信息时，触发本技能：

• 时事与新闻： 最新进展、热门话题、突发新闻
• 实时数据： 天气、股票价格、汇率、体育比分
• 信息查询： “什么是……”、“请介绍……”、产品评测、对比分析、推荐建议
• 基于位置的信息： 餐厅、旅游目的地、本地景点、可参与活动
• 操作指南： 教程、分步说明、最佳实践
• 购物与价格： 商品价格、优惠信息、“哪里购买”
• 趋势与统计： 市场趋势、排行榜、数据分析
• 任何 Claude 知识可能已过时的问题

触发词：

• 简体中文：最近、什么、哪里、怎么样、如何、查、搜、找、推荐、比较、新闻、天气
• 繁體中文：最近、什麼、哪裡、怎麼樣、如何、查、搜、找、推薦、比較、新聞、天氣
• 日本語：最近、何、どこ、どう、検索、探す、おすすめ、比較、ニュース、天気
• English：latest, recent, what, where, how, best, search, find, compare, news, weather

显式指令： /felo-search、"search with felo"、"felo search"

请勿用于以下情况：

• 关于用户代码库的编程问题（除非涉及外部库/文档）
• 纯数学计算或逻辑推理
• 关于当前项目中文件的问题

配置步骤

1. 获取 API 密钥

1. 访问 felo.ai 并登录（或注册）
2. 点击右上角头像 → Settings（设置）
3. 进入 “API Keys”（API 密钥）标签页
4. 点击 “Create New Key”（创建新密钥）生成新的 API 密钥
5. 安全地复制并保存您的 API 密钥

2. 配置 API 密钥

设置环境变量 FELO_API_KEY：

Linux/macOS：

export FELO_API_KEY="your-api-key-here"

Windows（PowerShell）：

$env:FELO_API_KEY="your-api-key-here"

Windows（CMD）：

set FELO_API_KEY=your-api-key-here

如需永久生效，请将该变量添加至 shell 配置文件（如 ~/.bashrc 或 ~/.zshrc）或系统环境变量中。

执行方式

当本技能被触发后，请使用 Bash 工具按以下步骤执行：

步骤 1：检查 API 密钥

使用 Bash 工具验证 API 密钥是否已正确设置：

if [ -z "$FELO_API_KEY" ]; then
  echo "ERROR: FELO_API_KEY not set"
  exit 1
fi
echo "API key configured"

若 API 密钥未设置，请向用户说明配置方法并立即终止执行。

步骤 2：发起 API 请求

提取用户查询内容，并通过临时 JSON 文件调用 Felo API（以妥善处理特殊字符）：

# 创建查询 JSON（将 USER_QUERY 替换为实际查询内容）
cat > /tmp/felo_query.json << 'EOF'
{"query": "USER_QUERY_HERE"}
EOF

# 调用 Felo API
curl -s -X POST https://openapi.felo.ai/v2/chat 
  -H "Authorization: Bearer $FELO_API_KEY" 
  -H "Content-Type: application/json" 
  -d @/tmp/felo_query.json

# 清理临时文件
rm -f /tmp/felo_query.json

注意事项：

• 请将 USER_QUERY_HERE 替换为用户的实际查询内容
• 使用 heredoc（cat > file << 'EOF'）确保正确处理中文、日文及各类特殊字符
• 使用 curl 的 -s 参数以获得简洁输出

步骤 3：解析并格式化响应结果

API 返回的 JSON 结构如下：

{
  "answer": "AI-generated answer text",
  "query_analysis": ["optimized query 1", "optimized query 2"]
}

请解析该 JSON 响应，并按如下格式向用户呈现结果：

## Answer
[显示 answer 字段内容]

## Query Analysis
Optimized search terms: [列出 query_analysis 中的各项]

完整示例

示例 1：天气查询

用户提问： “What's the weather in Tokyo today?”（今天东京天气如何？）

预期响应格式：

## Answer
Tokyo weather today: Sunny, 22°C (72°F). High of 25°C, low of 18°C.
Light winds from the east at 10 km/h. UV index: 6 (high).
Good day for outdoor activities!

## Query Analysis
Optimized search terms: Tokyo weather today, 東京 天気 今日

Bash 命令：

cat > /tmp/felo_query.json << 'EOF'
{"query": "What's the weather in Tokyo today?"}
EOF

curl -s -X POST https://openapi.felo.ai/v2/chat 
  -H "Authorization: Bearer $FELO_API_KEY" 
  -H "Content-Type: application/json" 
  -d @/tmp/felo_query.json

rm -f /tmp/felo_query.json

示例 2：本地新闻 / 事件

用户提问： “What's new in Hangzhou recently?”（杭州最近有什么新动态？）

预期响应格式：

## Answer
Recent news in Hangzhou: Asian Games venue upgrades completed, West Lake night tours launched, new metro lines opened. Details...

## Query Analysis
Optimized search terms: Hangzhou recent news, Hangzhou events, 杭州 最近 新闻

Bash 命令：

cat > /tmp/felo_query.json << 'EOF'
{"query": "What's new in Hangzhou recently"}
EOF

curl -s -X POST https://openapi.felo.ai/v2/chat 
  -H "Authorization: Bearer $FELO_API_KEY" 
  -H "Content-Type: application/json" 
  -d @/tmp/felo_query.json

rm -f /tmp/felo_query.json

示例 3：旅行 / 可参与活动

用户提问： “What are the best things to do in Taipei?”（台北有哪些必做之事？）

Bash 命令：

cat > /tmp/felo_query.json << 'EOF'
{"query": "What are the best things to do in Taipei"}
EOF

curl -s -X POST https://openapi.felo.ai/v2/chat 
  -H "Authorization: Bearer $FELO_API_KEY" 
  -H "Content-Type: application/json" 
  -d @/tmp/felo_query.json

rm -f /tmp/felo_query.json

示例 4：餐厅 / 推荐

用户提问： “Popular restaurants in Tokyo?”（东京有哪些热门餐厅？）

Bash 命令：

cat > /tmp/felo_query.json << 'EOF'
{"query": "Popular restaurants in Tokyo"}
EOF

curl -s -X POST https://openapi.felo.ai/v2/chat 
  -H "Authorization: Bearer $FELO_API_KEY" 
  -H "Content-Type: application/json" 
  -d @/tmp/felo_query.json

rm -f /tmp/felo_query.json

错误处理

常见错误码

• INVALID_API_KEY — API 密钥无效或已被撤销
  • 解决方案：确认 API 密钥是否正确，且未被撤销
• MISSING_PARAMETER — 缺少必需参数
  • 解决方案：确保已提供 query 参数
• INVALID_PARAMETER — 参数值无效
  • 解决方案：检查查询内容格式是否符合要求
• CHAT_FAILED — 内部服务错误
  • 解决方案：重试请求，或联系 Felo 技术支持

未配置 API 密钥

若 FELO_API_KEY 未设置，请显示如下提示信息：

❌ Felo API Key not configured

To use this skill, you need to set up your Felo API Key:

1. Get your API key from https://felo.ai (Settings → API Keys)
2. Set the environment variable:

   Linux/macOS:
   export FELO_API_KEY="your-api-key-here"

   Windows (PowerShell):
   $env:FELO_API_KEY="your-api-key-here"

3. Restart Claude Code or reload the environment

API 配置

端点地址： https://openapi.felo.ai/v2/chat

认证方式： 在 Authorization 请求头中使用 Bearer Token（取自 FELO_API_KEY 环境变量）

请求格式：

{
  "query": "user's search query"
}

响应格式：

{
  "answer": "AI-generated comprehensive answer",
  "query_analysis": ["optimized query 1", "optimized query 2"]
}

重要说明

• 本技能适用于所有需要最新信息的提问
• 请立即使用 Bash 工具执行操作，不要仅描述执行步骤
• 多语言支持：完全支持简体中文、繁體中文（台湾）、日本語和 English
• 正确处理特殊字符：使用 heredoc 创建 JSON 文件，避免编码问题
• 解析 JSON 响应：准确提取 answer 和 query_analysis 字段
• 格式清晰美观：使用规范 Markdown 格式展示结果，确保可读性
• API 尽可能返回与查询语言一致的结果

附加资源

• Felo 开放平台文档
• 获取 API 密钥（Settings → API Keys）
• API 参考文档