felo-search

Felo 搜索技能

使用时机

遇到需要当前或实时信息的问题时，触发此技能：

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

触发词：

• 简体中文：最近、什么、哪里、怎么样、如何、查、搜、找、推荐、比较、新闻、天气
• 繁體中文：最近、什麼、哪裡、怎麼樣、如何、查、搜、找、推薦、比較、新聞、天氣
• 日本語：最近、何、どこ、どう、検索、探す、おすすめ、比較、ニュース、天気
• English：最新、近期、什么、哪里、如何、最好、搜索、查找、比较、新闻、天气

明确命令： /felo-search、“search with felo”、“felo search”

不要用于：

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

设置

1. 获取 API 密钥

1. 访问 felo.ai 并登录（或注册）
2. 点击右上角的头像 → Settings
3. 前往“API Keys”选项卡
4. 点击“Create New Key”以生成新的 API Key
5. 复制并妥善保存 API Key

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 工具执行搜索脚本：

~/.agents/skills/felo-search/scripts/search.sh "USER_QUERY_HERE"

注意：

• 将 USER_QUERY_HERE 替换为实际的用户查询
• 脚本会处理 API 密钥验证、JSON 转义和 API 调用
• 支持所有特殊字符、Unicode（中文、日文等）和引号

解析并整理响应

API 返回的 JSON 具有以下结构：

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

请按以下格式向用户呈现响应：

## Answer
[Display the answer field]

## Query Analysis
Optimized search terms: [list query_analysis items]

完整示例

示例 1：天气查询

用户提问：“今天东京的天气怎么样？”

预期响应格式：

## 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 命令：

~/.agents/skills/felo-search/scripts/search.sh "What's the weather in Tokyo today?"

示例 2：本地新闻／活动

用户提问：“杭州最近有什么新消息？”

预期响应格式：

## 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 命令：

~/.agents/skills/felo-search/scripts/search.sh "What's new in Hangzhou recently"

示例 3：旅行／可参与的活动

用户提问：“台北有哪些最值得体验的活动？”

Bash 命令：

~/.agents/skills/felo-search/scripts/search.sh "What are the best things to do in Taipei"

示例 4：餐厅／推荐

用户提问：“东京有哪些热门餐厅？”

Bash 命令：

~/.agents/skills/felo-search/scripts/search.sh "Popular restaurants in Tokyo"

错误处理

常见错误代码

• INVALID_API_KEY - API Key 无效或已撤销
  • 解决方法：检查 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 令牌（来自 FELO_API_KEY 环境变量）

请求格式：

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

响应格式：

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

重要说明

• 任何需要当前信息的问题都应使用此技能
• 立即使用 Bash 工具执行，不要只描述你会怎么做
• 支持多种语言：完全支持简体中文、繁体中文（台湾）、日语和英语
• 正确处理特殊字符：使用搜索脚本，它会通过 sed 处理 JSON 转义
• 解析 JSON 响应：提取 answer 和 query_analysis 字段
• 美观地呈现结果：使用格式清晰、易读的 Markdown
• API 会尽可能以与查询相同的语言返回结果

更多资源

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