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:

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

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:

~/.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:

~/.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:

~/.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:

~/.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

• 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 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 Skill for Claude Code

Real-time web search with AI-generated answers.

Get current information on anything - weather, news, tech docs, reviews, prices. Works in Chinese, English, Japanese, and Korean.

---

What It Does

Felo Search integrates Felo AI into Claude Code, enabling:

• Real-time web search for current information
• AI-generated comprehensive answers
• Multi-language support (auto-detects query language)
• Automatic triggering for questions needing current data

When to use:

• Current events, news, weather
• Product reviews, prices, comparisons
• Latest documentation, tech trends
• Location info (restaurants, attractions)
• Any question with "latest", "recent", "best", "how to"

When NOT to use:

• Code questions about your local project
• Pure math or logic problems
• Questions about files in your workspace

---

Quick Setup

Step 1: Install

一键安装（推荐）：

npx skills add Felo-Inc/felo-skills --skill felo-search

手动安装： 若上述命令不可用，可克隆本仓库后将 felo-search 复制到 Claude Code 的 skills 目录：

Linux/macOS:

cp -r felo-search ~/.claude/skills/

Windows (PowerShell):

Copy-Item -Recurse felo-search "$env:USERPROFILE\.claude\skills\"

(Clone this repo first if needed: git clone https://github.com/Felo-Inc/felo-skills.git.)

Verify: Restart Claude Code and run:

claude skills list

You should see felo-search in the output.

Step 2: Get API Key

1. Visit felo.ai and log in (or register) 2. Click your avatar (top right) → Settings 3. Navigate to API Keys tab 4. Click Create New Key 5. Copy your API key

Step 3: Configure

Set the FELO_API_KEY environment variable:

Linux/macOS:

export FELO_API_KEY="your-api-key-here"

# Make it permanent (add to shell profile)
echo 'export FELO_API_KEY="your-api-key-here"' >> ~/.bashrc  # or ~/.zshrc

Windows (PowerShell):

$env:FELO_API_KEY="your-api-key-here"

# Make it permanent (system environment variables)
# System Properties → Advanced → Environment Variables → New

Windows (CMD):

set FELO_API_KEY=your-api-key-here

Verify: Check the variable is set:

# Linux/macOS
echo $FELO_API_KEY

# Windows PowerShell
echo $env:FELO_API_KEY

You should see your API key.

Restart Claude Code to load the environment variable.

Step 4: Test

Ask Claude a question requiring current information:

What's the weather in Tokyo today?

If you see an AI-generated answer, you're all set!

---

Usage Examples

Daily Life

Weather

You: What's the weather in Tokyo today?
Claude: Currently 15°C in Tokyo with partly cloudy skies. High of 18°C,
        low of 12°C. 20% chance of rain.

You: What's the weather in Hangzhou tomorrow?
Claude: Hangzhou tomorrow: partly cloudy to clear, 8-16°C, NE wind 3-4.

Restaurants & Food

You: Best ramen in Osaka
Claude: Top 3 ramen shops in Osaka:
        1. Ichiran Dotonbori - Famous tonkotsu ramen, open 24/7
        2. Kamukura - Rich chicken broth, Michelin Bib Gourmand
        3. Menya Joroku - Tsukemen specialist

You: Where to find the best xiaolongbao in Shanghai?
Claude: Shanghai xiaolongbao recommendations:
        1. Nanxiang Steamed Bun - Old brand near Yuyuan, thin skin, juicy
        2. Jiajia Soup Dumplings - Popular on Huanghe Road, good value
        3. Din Tai Fung - Taiwan brand, consistent quality

Shopping & Prices

You: iPhone 15 Pro price comparison
Claude: iPhone 15 Pro (128GB) prices:
        - Apple Store: $999
        - Amazon: $979 (save $20)
        - Best Buy: $999 (with trade-in deals)

You: MacBook Air M3 price
Claude: MacBook Air M3 (13") prices:
        - Apple: $1,099 (256GB)
        - Amazon: $1,049 (with coupons)
        - Best Buy: $1,079 (with perks)

Travel

You: Things to do in Kyoto this weekend
Claude: Kyoto weekend highlights:
        - Cherry blossom viewing at Maruyama Park (peak season)
        - Fushimi Inari Shrine (open 24/7, less crowded early morning)
        - Nishiki Market food tour (closes 6pm)
        - Gion district evening walk (geisha spotting)

You: What to do in Taipei?
Claude: Taipei must-sees:
        - Taipei 101 - Observatory for night views
        - National Palace Museum - Chinese art and artifacts
        - Shilin Night Market - Food and snacks
        - Jiufen Old Street - Nostalgic mountain town

Developer Scenarios

Latest Documentation

You: React 19 new features
Claude: React 19 key features (released Dec 2024):
        - React Compiler (auto-optimization)
        - Server Components stable
        - Actions for form handling
        - use() hook for async data

You: Next.js 15 new features
Claude: Next.js 15 main updates:
        - Turbopack stable (5x faster builds)
        - Partial Prerendering (PPR)
        - Improved cache control
        - React 19 support

Library Comparison

You: Vite vs Webpack 2024 comparison
Claude: Vite vs Webpack (2024):

        Build Speed: Vite 10x faster (dev), 3x faster (prod)
        Config: Vite simpler, Webpack more flexible
        Ecosystem: Webpack mature, Vite growing fast

        Use Vite for: New projects, fast iteration
        Use Webpack for: Complex builds, legacy support

You: Vue 3 vs React for new projects
Claude: Vue 3 vs React:

        Learning curve: Vue gentler, React needs JSX
        Performance: Similar, Vue slightly ahead
        Ecosystem: React larger, Vue sufficient
        Jobs: More React positions

        Suggestion: React if team knows it, Vue for newcomers

Tech Trends

You: Latest AI developments January 2026
Claude: AI developments (Jan 2026):
        - OpenAI GPT-5 preview released
        - Google Gemini 2.0 with multimodal reasoning
        - Anthropic Claude 4 with extended context
        - Meta's open-source LLaMA 4

You: Important tech news recently
Claude: Recent tech (Feb 2026):
        - Apple Vision Pro 2 announced
        - NVIDIA B100 GPU in production
        - Tesla FSD v13 rollout
        - Microsoft Windows 12 preview

Multi-language Queries

Felo supports Chinese, Japanese, Korean, and English. Ask in any language and get answers in that language. Example in English:

Latest AI & places

You: Latest developments in AI
Claude: AI developments (2026):
        - LLM parameters exceed 10 trillion
        - Multimodal understanding near human level
        - AI coding assistants used by 60%+ developers
        - Embodied AI robots commercialized
        [Sources: industry reports]

You: What to do in Shenzhen
Claude: Shenzhen recommendations:
        - Window of the World - Miniature landmarks
        - Happy Valley - Theme park
        - Dameisha Beach - Free beach
        - OCT-LOFT - Arts and culture
        [Sources: travel guides]

React adoption & comparisons

You: React adoption in China
Claude: React in China:
        - Market share: ~45% (second to Vue)
        - Major users: Alibaba, ByteDance, Tencent
        - Ecosystem: Ant Design, Taro, etc.
        - Trend: Growing, Next.js popular
        [Sources: State of JS China]

You: Python vs Java for beginners
Claude: Python vs Java:
        - Learning: Python easier to start
        - Jobs: Both strong, Java more enterprise
        - Use Python for: Data, scripting, prototyping
        - Use Java for: Enterprise, Android, backend
        [Sources: Stack Overflow, job boards]

Complex Queries

Research & Analysis

You: Impact of AI on software development 2024-2026
Claude: AI's impact on software development (2024-2026):

        Productivity: 40% faster coding with AI assistants
        Job Market: Shift from coding to architecture/design
        Tools: GitHub Copilot, Cursor, Claude Code dominant
        Challenges: Code quality, security, over-reliance

        Future: AI pair programming becomes standard practice

You: Impact of quantum computing on cryptography
Claude: Quantum computing and cryptography:

        Threat: RSA, ECC and similar algorithms could be broken
        Timeline: Estimated 2030-2035
        Response: Post-quantum cryptography (PQC) standardization
        Progress: NIST has published PQC algorithm standards

        Advice: Plan crypto migration in advance

Comparisons

You: Cloud providers comparison: AWS vs Azure vs GCP
Claude: AWS vs Azure vs GCP (2026):

        Market Share: AWS 32%, Azure 23%, GCP 10%
        Pricing: GCP cheapest, AWS most expensive
        Services: AWS most comprehensive, Azure best for Microsoft stack
        Performance: Similar, regional differences
        Support: Azure best for enterprise, AWS most docs

        Choose AWS: Mature ecosystem, most services
        Choose Azure: Microsoft integration, hybrid cloud
        Choose GCP: Data/ML workloads, cost-sensitive

You: Programming language performance: Python vs Go vs Rust
Claude: Python vs Go vs Rust:

        Speed: Rust > Go > Python (up to 100x)
        Memory: Rust lowest, Python highest
        Productivity: Python > Go > Rust
        Learning curve: Python gentlest, Rust steepest

        Use cases:
        - Python: Data science, scripting, rapid prototyping
        - Go: Microservices, cloud-native, concurrency
        - Rust: Systems programming, performance-critical, safety

[See 40+ more examples →](../docs/EXAMPLES.md)

---

How It Works

Auto-trigger

The skill automatically triggers for questions containing:

• Time-sensitive: "latest", "recent", "today", "now", "2026"
• Information: "what is", "tell me about", "how to"
• Comparison: "best", "top", "vs", "compare"
• Location: "where", "in [city]", "near me"
• Chinese: "最近", "什么", "哪里", "怎么样"
• Japanese: "最近", "何", "どこ", "どう"
• Korean: "최근", "무엇", "어디", "어떻게"

Manual Trigger

Force the skill to run:

/felo-search your query here

Or use trigger phrases:

Search with Felo for [query]
Felo search: [query]
Use Felo to find [query]

Response Format

Each response includes:

1. Answer - AI-generated comprehensive answer 2. Query Analysis - Optimized search queries used by Felo

Example:

## Answer
[Comprehensive AI-generated answer]

## Query Analysis
Optimized queries: ["query 1", "query 2"]

---

Troubleshooting

"FELO_API_KEY not set" error

Problem: Environment variable not configured.

Solution:

# Linux/macOS
export FELO_API_KEY="your-key"

# Windows PowerShell
$env:FELO_API_KEY="your-key"

Then restart Claude Code.

"INVALID_API_KEY" error

Problem: API key is incorrect or revoked.

Solution: Generate a new key at felo.ai (Settings → API Keys).

"curl: command not found" error

Problem: curl is not installed.

Solution:

# Linux (Debian/Ubuntu)
sudo apt install curl

# macOS
brew install curl

# Windows
# curl is built-in on Windows 10+

Skill not triggering automatically

Problem: Query doesn't match trigger keywords.

Solution: Use manual trigger:

/felo-search your query

Character encoding issues (Chinese/Japanese)

Problem: Special characters not displaying correctly.

Solution: Ensure your terminal supports UTF-8 encoding. The skill uses heredoc to handle special characters properly.

[See full FAQ →](../docs/FAQ.md)

---

Links

• [Get API Key](https://felo.ai) - Settings → API Keys
• [API Documentation](https://openapi.felo.ai) - Full API reference
• [Usage Examples](../docs/EXAMPLES.md) - 40+ real-world examples
• [FAQ](../docs/FAQ.md) - Common issues and solutions
• [Report Issues](https://github.com/Felo-Inc/felo-skills/issues) - Bug reports and feature requests

---

License

MIT License - see LICENSE for details.