\r \r

Felo Search Skill\r

\r

When to Use\r

\r Trigger this skill for questions requiring current or real-time information:\r \r

• Current events & news: Recent developments, trending topics, breaking news\r
• Real-time data: Weather, stock prices, exchange rates, sports scores\r
• Information queries: "What is...", "Tell me about...", product reviews, comparisons, recommendations\r
• Location-based: Restaurants, travel destinations, local attractions, things to do\r
• How-to guides: Tutorials, step-by-step instructions, best practices\r
• Shopping & prices: Product prices, deals, "where to buy"\r
• Trends & statistics: Market trends, rankings, data analysis\r
• Any question where Claude's knowledge may be outdated\r \r Trigger words:\r
• 简体中文: 最近、什么、哪里、怎么样、如何、查、搜、找、推荐、比较、新闻、天气\r
• 繁體中文: 最近、什麼、哪裡、怎麼樣、如何、查、搜、找、推薦、比較、新聞、天氣\r
• 日本語: 最近、何、どこ、どう、検索、探す、おすすめ、比較、ニュース、天気\r
• English: latest, recent, what, where, how, best, search, find, compare, news, weather\r \r Explicit commands: /felo-search, "search with felo", "felo search"\r \r Do NOT use for:\r
• Code questions about the user's codebase (unless asking about external libraries/docs)\r
• Pure mathematical calculations or logical reasoning\r
• Questions about files in the current project\r \r

Setup\r

\r

1. Get Your API Key\r

\r

1. Visit felo.ai and log in (or register)\r
2. Click your avatar in the top right corner → Settings\r
3. Navigate to the "API Keys" tab\r
4. Click "Create New Key" to generate a new API Key\r
5. Copy and save your API Key securely\r \r

2. Configure API Key\r

\r Set the FELO_API_KEY environment variable:\r \r Linux/macOS:\r

export FELO_API_KEY="your-api-key-here"\r
```\r
\r
**Windows (PowerShell):**\r
```powershell\r
$env:FELO_API_KEY="your-api-key-here"\r
```\r
\r
**Windows (CMD):**\r
```cmd\r
set FELO_API_KEY=your-api-key-here\r
```\r
\r
For permanent configuration, add it to your shell profile (~/.bashrc, ~/.zshrc) or system environment variables.\r
\r
## How to Execute\r
\r
When this skill is triggered, execute the following steps using the Bash tool:\r
\r
### Step 1: Check API Key\r
\r
Use the Bash tool to verify the API key is set:\r
\r
```bash\r
if [ -z "$FELO_API_KEY" ]; then\r
  echo "ERROR: FELO_API_KEY not set"\r
  exit 1\r
fi\r
echo "API key configured"\r
```\r
\r
If the API key is not set, inform the user with setup instructions and STOP.\r
\r
### Step 2: Make API Request\r
\r
Extract the user's query and call the Felo API using a temporary JSON file to handle special characters:\r
\r
```bash\r
# Create query JSON (replace USER_QUERY with actual query)\r
cat > /tmp/felo_query.json \x3C\x3C 'EOF'\r
{"query": "USER_QUERY_HERE"}\r
EOF\r
\r
# Call Felo API\r
curl -s -X POST https://openapi.felo.ai/v2/chat \\r
  -H "Authorization: Bearer $FELO_API_KEY" \\r
  -H "Content-Type: application/json" \\r
  -d @/tmp/felo_query.json\r
\r
# Clean up\r
rm -f /tmp/felo_query.json\r
```\r
\r
**Notes:**\r
- Replace `USER_QUERY_HERE` with the actual user query\r
- Use heredoc (`cat > file \x3C\x3C 'EOF'`) to properly handle Chinese, Japanese, and special characters\r
- Use `-s` flag with curl for clean output\r
\r
### Step 3: Parse and Format Response\r
\r
The API returns JSON with this structure:\r
```json\r
{\r
  "answer": "AI-generated answer text",\r
  "query_analysis": ["optimized query 1", "optimized query 2"]\r
}\r
```\r
\r
Parse the JSON response and present it to the user in this format:\r
\r
```\r
## Answer\r
[Display the answer field]\r
\r
## Query Analysis\r
Optimized search terms: [list query_analysis items]\r
```\r
\r
## Complete Examples\r
\r
### Example 1: Weather query\r
\r
**User asks:** "What's the weather in Tokyo today?"\r
\r
**Expected response format:**\r
```\r
## Answer\r
Tokyo weather today: Sunny, 22°C (72°F). High of 25°C, low of 18°C.\r
Light winds from the east at 10 km/h. UV index: 6 (high).\r
Good day for outdoor activities!\r
\r
## Query Analysis\r
Optimized search terms: Tokyo weather today, 東京 天気 今日\r
```\r
\r
**Bash command:**\r
```bash\r
cat > /tmp/felo_query.json \x3C\x3C 'EOF'\r
{"query": "What's the weather in Tokyo today?"}\r
EOF\r
\r
curl -s -X POST https://openapi.felo.ai/v2/chat \\r
  -H "Authorization: Bearer $FELO_API_KEY" \\r
  -H "Content-Type: application/json" \\r
  -d @/tmp/felo_query.json\r
\r
rm -f /tmp/felo_query.json\r
```\r
\r
### Example 2: Local news / events\r
\r
**User asks:** "What's new in Hangzhou recently?"\r
\r
**Expected response format:**\r
```\r
## Answer\r
Recent news in Hangzhou: Asian Games venue upgrades completed, West Lake night tours launched, new metro lines opened. Details...\r
\r
## Query Analysis\r
Optimized search terms: Hangzhou recent news, Hangzhou events, 杭州 最近 新闻\r
```\r
\r
**Bash command:**\r
```bash\r
cat > /tmp/felo_query.json \x3C\x3C 'EOF'\r
{"query": "What's new in Hangzhou recently"}\r
EOF\r
\r
curl -s -X POST https://openapi.felo.ai/v2/chat \\r
  -H "Authorization: Bearer $FELO_API_KEY" \\r
  -H "Content-Type: application/json" \\r
  -d @/tmp/felo_query.json\r
\r
rm -f /tmp/felo_query.json\r
```\r
\r
### Example 3: Travel / things to do\r
\r
**User asks:** "What are the best things to do in Taipei?"\r
\r
**Bash command:**\r
```bash\r
cat > /tmp/felo_query.json \x3C\x3C 'EOF'\r
{"query": "What are the best things to do in Taipei"}\r
EOF\r
\r
curl -s -X POST https://openapi.felo.ai/v2/chat \\r
  -H "Authorization: Bearer $FELO_API_KEY" \\r
  -H "Content-Type: application/json" \\r
  -d @/tmp/felo_query.json\r
\r
rm -f /tmp/felo_query.json\r
```\r
\r
### Example 4: Restaurants / recommendations\r
\r
**User asks:** "Popular restaurants in Tokyo?"\r
\r
**Bash command:**\r
```bash\r
cat > /tmp/felo_query.json \x3C\x3C 'EOF'\r
{"query": "Popular restaurants in Tokyo"}\r
EOF\r
\r
curl -s -X POST https://openapi.felo.ai/v2/chat \\r
  -H "Authorization: Bearer $FELO_API_KEY" \\r
  -H "Content-Type: application/json" \\r
  -d @/tmp/felo_query.json\r
\r
rm -f /tmp/felo_query.json\r
```\r
\r
## Error Handling\r
\r
### Common Error Codes\r
\r
- `INVALID_API_KEY` - API Key is invalid or revoked\r
  - Solution: Check if your API key is correct and hasn't been revoked\r
- `MISSING_PARAMETER` - Required parameter is missing\r
  - Solution: Ensure the query parameter is provided\r
- `INVALID_PARAMETER` - Parameter value is invalid\r
  - Solution: Check the query format\r
- `CHAT_FAILED` - Internal service error\r
  - Solution: Retry the request or contact Felo support\r
\r
### Missing API Key\r
\r
If `FELO_API_KEY` is not set, display this message:\r
\r
```\r
❌ Felo API Key not configured\r
\r
To use this skill, you need to set up your Felo API Key:\r
\r
1. Get your API key from https://felo.ai (Settings → API Keys)\r
2. Set the environment variable:\r
\r
   Linux/macOS:\r
   export FELO_API_KEY="your-api-key-here"\r
\r
   Windows (PowerShell):\r
   $env:FELO_API_KEY="your-api-key-here"\r
\r
3. Restart Claude Code or reload the environment\r
```\r
\r
## API Configuration\r
\r
**Endpoint:** `https://openapi.felo.ai/v2/chat`\r
\r
**Authentication:** Bearer token in Authorization header (from `FELO_API_KEY` environment variable)\r
\r
**Request format:**\r
```json\r
{\r
  "query": "user's search query"\r
}\r
```\r
\r
**Response format:**\r
```json\r
{\r
  "answer": "AI-generated comprehensive answer",\r
  "query_analysis": ["optimized query 1", "optimized query 2"]\r
}\r
```\r
\r
## Important Notes\r
\r
- This skill should be used for any question requiring current information\r
- Execute immediately using the Bash tool - don't just describe what you would do\r
- Multi-language support: Fully supports Simplified Chinese, Traditional Chinese (Taiwan), Japanese, and English\r
- Handle special characters properly: Use heredoc for JSON files to avoid encoding issues\r
- Parse JSON response: Extract answer and query_analysis fields\r
- Format nicely: Present results in a clean, readable format with proper markdown\r
- The API returns results in the same language as the query when possible\r
\r
## Additional Resources\r
\r
- [Felo Open Platform Documentation](https://openapi.felo.ai)\r
- [Get API Key](https://felo.ai) (Settings → API Keys)\r
- [API Reference](https://openapi.felo.ai/docs)\r