Felo Search

Felo Search Skill

When to Use

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

Trigger words:

Explicit commands: /felo-search, "search with felo", "felo search"

Do NOT use for:

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

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

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

Additional Resources

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.