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 Visit felo.ai and log in (or register) Click your avatar in the top right corner → Settings Navigate to the "API Keys" tab Click "Create New Key" to generate a new API Key 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 following steps using the Bash tool: Step 1: Check API Key Use the Bash tool to verify the API key is set: 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. Step 2: Make API Request Extract the user's query and call the Felo API using a temporary JSON file to handle special characters:
Create query JSON (replace USER_QUERY with actual query)
cat
/tmp/felo_query.json << 'EOF' {"query": "USER_QUERY_HERE"} EOF
Call 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
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 Step 3: Parse and Format Response The API returns JSON with this structure: { "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:
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: 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 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: 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 User asks: "What are the best things to do in Taipei?" Bash command: 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 User asks: "Popular restaurants in Tokyo?" Bash command: 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 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 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 Additional Resources Felo Open Platform Documentation Get API Key (Settings → API Keys) API Reference