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:

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.

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:

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.

Step 2: Make API Request

Extract the user's query and call the Felo API using a temporary JSON file to handle special characters:

bash

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

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:

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

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:

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

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

Example 4: Restaurants / recommendations

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

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

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:

json

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

Response format:

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

felo-search

NPX Install

Tags

SKILL.md Content

Felo Search Skill

When to Use

Setup

1. Get Your API Key

2. Configure API Key

How to Execute

Step 1: Check API Key

Step 2: Make API Request

Step 3: Parse and Format Response

Complete Examples

Example 1: Weather query

Example 2: Local news / events

Example 3: Travel / things to do

Example 4: Restaurants / recommendations

Error Handling

Common Error Codes

Missing API Key

API Configuration

Important Notes

Additional Resources