mcpField
F
felo-search

felo-search

github.com/felo-inc生産性250278 回インストール14 週間前に更新
リポジトリ

felo-search について

felo-searchは、Felo APIを通じて最新情報を調べるスキルです。ニュース、リアルタイムデータ、地域のおすすめ、手順案内などを検索し、回答とクエリ分析を返します。

主な機能

  1. 01ニュースやリアルタイム情報を検索
  2. 02地域の場所や旅行先を探す
  3. 03価格、動向、おすすめを調査
  4. 04Felo API経由でクエリを送信
  5. 05回答とクエリ分析を返却

活用シーン

  1. 01最近のニュースや天気を確認
  2. 02現在の価格や為替レートを調査
  3. 03地域の飲食店や観光地を探す
  4. 04最新の手順や製品比較を調べる

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/felo-inc/felo-skills --skill felo-search

インストール後、Claude Code で/felo-searchを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

LICENSE
README.md
scripts/
search.sh

詳細

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"]
}

重要な注意事項

  • 最新情報が必要な質問には、このスキルを使用してください
  • Bash ツールを使ってすぐに実行してください。実行方法を説明するだけにしないでください
  • 多言語対応：簡体字中国語、繁体字中国語（台湾）、日本語、英語に完全対応しています
  • 特殊文字を適切に処理してください：sed を使った JSON エスケープ処理に対応している検索スクリプトを使用してください
  • JSON レスポンスを解析してください：answer フィールドと query_analysis フィールドを抽出してください
  • 見やすく整えてください：適切な Markdown を使って、すっきりと読みやすい形式で結果を提示してください
  • 可能な場合、API はクエリと同じ言語で結果を返します

追加リソース

コメント

Markdown 対応