Back to Details

felo-search

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Felo Search Skill

Felo搜索Skill

When to Use

适用场景

Trigger this skill for questions requiring current or real-time information:
  • Current events & news: Recent developments, trending topics, breaking news
  • Real-time data: Weather, stock prices, exchange rates, sports scores
  • Information queries: "What is...", "Tell me about...", product reviews, comparisons, recommendations
  • Location-based: Restaurants, travel destinations, local attractions, things to do
  • How-to guides: Tutorials, step-by-step instructions, best practices
  • Shopping & prices: Product prices, deals, "where to buy"
  • Trends & statistics: Market trends, rankings, data analysis
  • Any question where Claude's knowledge may be outdated
Trigger words:
  • 简体中文: 最近、什么、哪里、怎么样、如何、查、搜、找、推荐、比较、新闻、天气
  • 繁體中文: 最近、什麼、哪裡、怎麼樣、如何、查、搜、找、推薦、比較、新聞、天氣
  • 日本語: 最近、何、どこ、どう、検索、探す、おすすめ、比較、ニュース、天気
  • English: latest, recent, what, where, how, best, search, find, compare, news, weather
Explicit commands: 
/felo-search
, "search with felo", "felo search"
Do NOT use for:
  • Code questions about the user's codebase (unless asking about external libraries/docs)
  • Pure mathematical calculations or logical reasoning
  • Questions about files in the current project
当问题需要当前或实时信息时，触发该技能：
  • 时事与新闻： 近期动态、热门话题、突发新闻
  • 实时数据： 天气、股票价格、汇率、体育赛事比分
  • 信息查询： "什么是..."、"告诉我关于..."、产品评测、对比、推荐
  • 基于位置的查询： 餐厅、旅行目的地、本地景点、可参与活动
  • 操作指南： 教程、分步说明、最佳实践
  • 购物与价格： 产品价格、优惠信息、"哪里可以购买"
  • 趋势与统计： 市场趋势、排名、数据分析
  • 任何Claude知识库可能过时的问题
触发词：
  • 简体中文: 最近、什么、哪里、怎么样、如何、查、搜、找、推荐、比较、新闻、天气
  • 繁體中文: 最近、什麼、哪裡、怎麼樣、如何、查、搜、找、推薦、比較、新聞、天氣
  • 日本語: 最近、何、どこ、どう、検索、探す、おすすめ、比較、ニュース、天気
  • English: latest, recent, what, where, how, best, search, find, compare, news, weather
明确指令： 
/felo-search
, "search with felo", "felo search"
不适用场景：
  • 关于用户代码库的代码问题（除非询问外部库/文档）
  • 纯数学计算或逻辑推理
  • 关于当前项目中文件的问题

Setup

配置步骤

1. Get Your API Key

1. 获取API密钥

  1. Visit felo.ai and log in (or register)
  2. Click your avatar in the top right corner → Settings
  3. Navigate to the "API Keys" tab
  4. Click "Create New Key" to generate a new API Key
  5. Copy and save your API Key securely
  1. 访问 felo.ai 并登录（或注册）
  2. 点击右上角头像 → 设置
  3. 导航至「API Keys」标签页
  4. 点击「Create New Key」生成新的API密钥
  5. 安全地复制并保存你的API密钥

2. Configure API Key

2. 配置API密钥

Set the 
FELO_API_KEY
environment variable:
Linux/macOS:
bash
export FELO_API_KEY="your-api-key-here"
Windows (PowerShell):
powershell
$env:FELO_API_KEY="your-api-key-here"
Windows (CMD):
cmd
set FELO_API_KEY=your-api-key-here
For permanent configuration, add it to your shell profile (~/.bashrc, ~/.zshrc) or system environment variables.
设置 
FELO_API_KEY
环境变量：
Linux/macOS：
bash
export FELO_API_KEY="your-api-key-here"
Windows (PowerShell)：
powershell
$env:FELO_API_KEY="your-api-key-here"
Windows (CMD)：
cmd
set FELO_API_KEY=your-api-key-here
如需永久配置，将其添加到Shell配置文件（/.bashrc、/.zshrc）或系统环境变量中。

How to Execute

执行步骤

When this skill is triggered, execute the following steps using the Bash tool:
当触发该技能时，使用Bash工具执行以下步骤：

Step 1: Check API Key

步骤1：检查API密钥

Use the Bash tool to verify the API key is set:
bash
if [ -z "$FELO_API_KEY" ]; then
  echo "ERROR: FELO_API_KEY not set"
  exit 1
fi
echo "API key configured"
If the API key is not set, inform the user with setup instructions and STOP.
使用Bash工具验证API密钥是否已设置：
bash
if [ -z "$FELO_API_KEY" ]; then
  echo "ERROR: FELO_API_KEY not set"
  exit 1
fi
echo "API key configured"
如果未设置API密钥，告知用户配置步骤并停止执行。

Step 2: Make API Request

步骤2：发起API请求

Extract the user's query and call the Felo API using a temporary JSON file to handle special characters:
bash
undefined
提取用户查询，使用临时JSON文件处理特殊字符，调用Felo API：
bash
undefined

Create query JSON (replace USER_QUERY with actual query)

创建查询JSON（替换USER_QUERY为实际查询）

cat > /tmp/felo_query.json << 'EOF' {"query": "USER_QUERY_HERE"} EOF
cat > /tmp/felo_query.json << 'EOF' {"query": "USER_QUERY_HERE"} EOF

Call Felo API

调用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
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

Clean up

清理文件

rm -f /tmp/felo_query.json

**Notes:**
- Replace `USER_QUERY_HERE` with the actual user query
- Use heredoc (`cat > file << 'EOF'`) to properly handle Chinese, Japanese, and special characters
- Use `-s` flag with curl for clean output
rm -f /tmp/felo_query.json

**注意事项：**
- 将 `USER_QUERY_HERE` 替换为实际用户查询
- 使用here文档（`cat > file << 'EOF'`）正确处理中文、日文和特殊字符
- 为curl命令添加 `-s` 参数以获得简洁输出

Step 3: Parse and Format Response

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

The API returns JSON with this structure:
json
{
  "answer": "AI-generated answer text",
  "query_analysis": ["optimized query 1", "optimized query 2"]
}
Parse the JSON response and present it to the user in this format:
undefined
API返回的JSON结构如下：
json
{
  "answer": "AI-generated answer text",
  "query_analysis": ["optimized query 1", "optimized query 2"]
}
解析JSON响应，并按以下格式呈现给用户：
undefined

Answer

回答

[Display the answer field]
[显示answer字段内容]

Query Analysis

查询分析

Optimized search terms: [list query_analysis items]
undefined
优化搜索词：[列出query_analysis中的条目]
undefined

Complete Examples

完整示例

Example 1: Weather query

示例1：天气查询

User asks: "What's the weather in Tokyo today?"
Expected response format:
undefined
用户提问： "今天东京的天气如何？"
预期响应格式：
undefined

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!
东京今日天气：晴，22°C（72°F）。最高温25°C，最低温18°C。 东风微风，风速10公里/小时。紫外线指数：6（高）。 适合户外活动！

Query Analysis

查询分析

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

**Bash command:**
```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
优化搜索词：东京今日天气，東京 天気 今日

**Bash命令：**
```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

Example 2: Local news / events

示例2：本地新闻/事件

User asks: "What's new in Hangzhou recently?"
Expected response format:
undefined
用户提问： "杭州最近有什么新动态？"
预期响应格式：
undefined

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 command:**
```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
优化搜索词：杭州近期新闻，杭州活动，杭州 最近 新闻

**Bash命令：**
```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

Example 3: Travel / things to do

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

User asks: "What are the best things to do in Taipei?"
Bash command:
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
用户提问： "台北有哪些必体验的项目？"
Bash命令：
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

Example 4: Restaurants / recommendations

示例4：餐厅/推荐

User asks: "Popular restaurants in Tokyo?"
Bash command:
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
用户提问： "东京热门餐厅有哪些？"
Bash命令：
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

Error Handling

错误处理

Common Error Codes

常见错误码

  • INVALID_API_KEY
    - API Key is invalid or revoked
    • Solution: Check if your API key is correct and hasn't been revoked
  • MISSING_PARAMETER
    - Required parameter is missing
    • Solution: Ensure the query parameter is provided
  • INVALID_PARAMETER
    - Parameter value is invalid
    • Solution: Check the query format
  • CHAT_FAILED
    - Internal service error
    • Solution: Retry the request or contact Felo support
  • INVALID_API_KEY
    - API密钥无效或已被撤销
    • 解决方案：检查API密钥是否正确且未被撤销
  • MISSING_PARAMETER
    - 缺少必填参数
    • 解决方案：确保提供了query参数
  • INVALID_PARAMETER
    - 参数值无效
    • 解决方案：检查查询格式
  • CHAT_FAILED
    - 内部服务错误
    • 解决方案：重试请求或联系Felo支持团队

Missing API Key

缺少API密钥

If 
FELO_API_KEY
is not set, display this message:
❌ 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
如果未设置 
FELO_API_KEY
，显示以下信息：
❌ Felo API密钥未配置

要使用该技能，你需要配置Felo API密钥：

1. 从 https://felo.ai 获取API密钥（设置 → API Keys）
2. 设置环境变量：

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

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

3. 重启Claude Code或重新加载环境

API Configuration

API配置

Endpoint: 
https://openapi.felo.ai/v2/chat
Authentication: Bearer token in Authorization header (from 
FELO_API_KEY
environment variable)
Request format:
json
{
  "query": "user's search query"
}
Response format:
json
{
  "answer": "AI-generated comprehensive answer",
  "query_analysis": ["optimized query 1", "optimized query 2"]
}
接口地址： 
https://openapi.felo.ai/v2/chat
认证方式： 在Authorization头中使用Bearer令牌（来自
FELO_API_KEY
环境变量）
请求格式：
json
{
  "query": "user's search query"
}
响应格式：
json
{
  "answer": "AI-generated comprehensive answer",
  "query_analysis": ["optimized query 1", "optimized query 2"]
}

Important Notes

重要说明

  • This skill should be used for any question requiring current information
  • Execute immediately using the Bash tool - don't just describe what you would do
  • Multi-language support: Fully supports Simplified Chinese, Traditional Chinese (Taiwan), Japanese, and English
  • Handle special characters properly: Use heredoc for JSON files to avoid encoding issues
  • Parse JSON response: Extract answer and query_analysis fields
  • Format nicely: Present results in a clean, readable format with proper markdown
  • The API returns results in the same language as the query when possible
  • 任何需要当前信息的问题都应使用该技能
  • 立即使用Bash工具执行，不要仅描述操作步骤
  • 多语言支持：完全支持简体中文、繁体中文（台湾）、日文和英文
  • 正确处理特殊字符：使用here文档创建JSON文件以避免编码问题
  • 解析JSON响应：提取answer和query_analysis字段
  • 格式化输出：使用清晰的Markdown格式呈现结果
  • API会尽可能以与查询相同的语言返回结果

Additional Resources

额外资源