Felo Search

Felo Search 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

Setup

1. Get Your API Key

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

2. Configure API Key

Set the FELO_API_KEY environment variable:

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

For permanent configuration, add it to your shell profile (~/.bashrc, ~/.zshrc) or system environment variables.

How to Execute

When this skill is triggered, execute the search script using the Bash tool:

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

⚠️ 路徑安全：skill 腳本位於 repo 根目錄的 .agents/skills/ 下。若 cwd 不在 repo root，請先執行 git rev-parse --show-toplevel 取得絕對路徑，再 cd 到該路徑後執行。禁止在指令中使用 $(...) 語法（會被 Copilot CLI 安全過濾器擋下）。

Notes:

• Replace USER_QUERY_HERE with the actual user query
• The script handles API key validation, JSON escaping, and API calls
• Supports all special characters, Unicode (Chinese, Japanese, etc.), and quotes

Parse and Format Response

The API returns JSON with this structure:

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

Present the response to the user in this format:

## Answer
[Display the answer field]

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

Complete Examples

Example 1: Weather query

User asks: "What's the weather in Tokyo today?"

Expected response format:

## 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 command:

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

Example 2: Local news / events

User asks: "What's new in Hangzhou recently?"

Expected response format:

## 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 .agents/skills/felo-search/scripts/search.sh "What's new in Hangzhou recently"

Example 3: Travel / things to do

User asks: "What are the best things to do in Taipei?"

Bash command:

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

Example 4: Restaurants / recommendations

User asks: "Popular restaurants in Tokyo?"

Bash command:

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

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

Missing API Key

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

API Configuration

Endpoint: https://openapi.felo.ai/v2/chat

Authentication: Bearer token in Authorization header (from FELO_API_KEY environment variable)

Request format:

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

Response format:

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

Important Notes

• ⚠️ 路徑安全：skill 腳本位於 repo root 的 .agents/skills/ 下。若 cwd 不在 repo root，先執行 git rev-parse --show-toplevel 取得路徑再 cd。禁止用 $(...) 語法。
• 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
• 預設輸出語言為繁體中文（zh-TW）。除非使用者明確指定其他語言，否則所有摘要、整理、說明等 AI 產出的文字，一律使用繁體中文輸出。
• Multi-language support: Fully supports Simplified Chinese, Traditional Chinese (Taiwan), Japanese, and English
• Handle special characters properly: Use the search script which handles JSON escaping via sed
• 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

Additional Resources

• Felo Open Platform Documentation
• Get API Key (Settings → API Keys)
• API Reference

🛠️ Felo Search（AI 網路搜尋）

讓小龍蝦幫你上網查資料！即時搜尋最新消息、新聞、天氣、比價，還會幫你整理成好讀的答案。

✨ 這個技能可以做什麼？

• 🔍 即時搜尋網路，取得最新、最即時的資訊
• 📰 查詢新聞、時事、趨勢、突發事件
• 🌤️ 查天氣、查價格、查評價、查旅遊資訊
• 🤖 回傳的不是一堆連結，而是 AI 整理過的答案，附帶來源引用
• 🌏 支援中文、英文、日文等多語言查詢

📦 安裝方式

安裝到目前值班的小龍蝦

在 Telegram 對話中輸入：

/skills add felo-search

安裝為全域技能（所有小龍蝦共用）

/skills add felo-search -g

⚙️ 需要的設定

使用前需要設定以下 API Key：

取得方式： 到 felo.ai → Settings → API Keys 申請取得。

💬 提示詞範例

以下是你可以直接複製貼上跟小龍蝦說的話：

今天台北的天氣如何？
最近有什麼科技新聞？
幫我查一下 iPhone 16 跟 Samsung S25 的比較。
這週末台中有什麼好玩的活動？
React 19 有哪些新功能？

📝 輸出範例

小龍蝦會回傳像這樣的 AI 整理答案：

今天台北天氣晴朗，最高溫 32°C，最低溫 26°C。
午後山區有局部雷陣雨的機率，建議攜帶雨具。

來源：
- 中央氣象署 (https://www.cwa.gov.tw)
- Weather.com (https://weather.com)

💡 小龍蝦不只是丟連結給你，而是讀完資料後用自然語言幫你整理重點！

⚠️ 注意事項

• 🌐 最適合查詢即時性、時效性的資訊
• 📡 需要網路連線才能使用
• 🔑 如果 API Key 失效，請到 felo.ai 重新產生

🔗 延伸閱讀

• 技術細節請參考 SKILL.md
• Felo Open Platform
• Felo API 文件
• 申請 API Key