SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场felo-search

felo-search

通用与其它

查看项目

更新于 10-15 09:10

技能介绍

用途

Felo Search 是一个实时联网搜索技能，用于处理需要当前或实时信息的问题。当 Claude 等模型自身知识可能过时时，可触发该技能获取最新结果。

适用场景包括：

  • 时事与新闻：近期动态、热门话题、突发新闻
  • 实时数据：天气、股价、汇率、体育比分
  • 信息查询：“什么是……”“介绍一下……”、产品评测、对比、推荐
  • 基于位置：餐厅、旅行目的地、本地景点、可玩项目
  • 操作指南：教程、分步说明、最佳实践
  • 购物与价格：商品价格、优惠、“在哪里买”
  • 趋势与统计：市场趋势、排行榜、数据分析

触发词涵盖简体中文（最近、什么、哪里、怎么样、如何、查、搜、找、推荐、比较、新闻、天气）、繁体中文、日语和英语的对应词汇，以及显式命令 /felo-search、“search with felo”、“felo search”。

不适用场景：关于用户自身代码库的代码问题（除非询问外部库/文档）、纯数学计算或逻辑推理、关于当前项目文件的问题。

主要能力

  • 调用 Felo AI 搜索接口，返回 AI 生成的综合答案
  • 返回优化后的搜索词（query_analysis）
  • 支持多语言：简体中文、繁体中文（台湾）、日语、英语
  • 尽可能以与查询相同的语言返回结果
  • 支持特殊字符、Unicode 和引号

使用方式

1. 获取 API Key

  1. 访问 felo.ai 并登录（或注册）
  2. 点击右上角头像 → Settings
  3. 进入 “API Keys” 标签页
  4. 点击 “Create New Key” 生成新的 API Key
  5. 复制并安全保存 API Key

2. 配置 API Key

设置 FELO_API_KEY 环境变量：

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

如需永久配置，可将其加入 shell 配置文件（~/.bashrc、~/.zshrc）或系统环境变量。

3. 执行搜索

技能触发后，使用 Bash 工具执行搜索脚本：

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

说明：将 USER_QUERY_HERE 替换为实际用户查询；脚本会处理 API Key 校验、JSON 转义和 API 调用；支持所有特殊字符、Unicode（中文、日文等）和引号。

4. 解析与格式化响应

API 返回的 JSON 结构为： { "answer": "AI-generated answer text", "query_analysis": ["optimized query 1", "optimized query 2"] }

向用户展示时使用如下格式：

Answer

[显示 answer 字段]

Query Analysis

Optimized search terms: [列出 query_analysis 各项]

适用场景示例

  • 天气查询：“What's the weather in Tokyo today?”
  • 本地新闻/活动：“What's new in Hangzhou recently?”
  • 旅行/可玩项目：“What are the best things to do in Taipei?”
  • 餐厅/推荐：“Popular restaurants in Tokyo?”

限制与错误处理

常见错误码：

  • INVALID_API_KEY：API Key 无效或已撤销。解决：检查 API Key 是否正确且未被撤销
  • MISSING_PARAMETER：缺少必需参数。解决：确保提供 query 参数
  • INVALID_PARAMETER：参数值无效。解决：检查查询格式
  • CHAT_FAILED：内部服务错误。解决：重试请求或联系 Felo 支持

若未设置 FELO_API_KEY，应显示提示信息，引导用户从 https://felo.ai（Settings → API Keys）获取 API Key 并设置环境变量，然后重启 Claude Code 或重新加载环境。

API 配置

  • Endpoint：https://openapi.felo.ai/v2/chat
  • 认证：Authorization 头中的 Bearer token（来自 FELO_API_KEY 环境变量）
  • 请求格式：{ "query": "user's search query" }
  • 响应格式：{ "answer": "AI-generated comprehensive answer", "query_analysis": ["optimized query 1", "optimized query 2"] }

重要说明

  • 任何需要当前信息的问题都应使用该技能
  • 应立即使用 Bash 工具执行，而不是仅描述将要做什么
  • 多语言支持：完整支持简体中文、繁体中文（台湾）、日语和英语
  • 正确处理特殊字符：使用搜索脚本，其通过 sed 处理 JSON 转义
  • 解析 JSON 响应：提取 answer 和 query_analysis 字段
  • 格式化输出：以清晰、可读的 markdown 格式呈现结果
  • 该技能的具体收费、价格等信息暂未提供