飞搜使用指南
飞搜帮助你发现公开分享的飞书文档和知识库。网页适合直接找资料，Skill 与 API 适合让 AI 助手或程序调用搜索。
如何搜索飞书公开文档
- 打开飞搜首页，输入主题、问题或文档标题，点击搜索。
- 根据结果的标题、摘要和知识库名称筛选，再打开原文确认内容与更新时间。
- 结果不合适时，缩小任务范围。例如把“AI”改为“AI 编程入门”，或加入工具名称。
想先按阅读路径挑选资料，可从AI 编程资料和AI Agent 资料开始。
为什么链接有时打不开？
原作者可能取消公开分享、删除文档或更改权限。飞搜无法授予原文权限，也不会搜索你的企业私有空间。可以换用完整标题搜索其他公开来源，或通过页面底部反馈失效链接。
搜索结果等于已经核实的答案吗？
搜索结果和 AI 摘要用于帮助定位资料。采用其中的结论、操作步骤或价格信息前，请回到原文核对；旧教程中的界面、模型和套餐可能已经变化。
Skill 安装
飞搜支持 Claude Code、Cursor、Codex 等 AI 编程助手通过 Skill 直接搜索飞书云文档。
交给助手安装
复制下面这句话发给支持读取 Skill 文件的 AI 助手，按该工具的安装流程完成配置：
请帮我安装飞书文档搜索 Skill：https://feisou.app/skill/feisou-search.md
设置 API Key
在 控制台 登录后创建 Key，然后通过本地凭据管理器或受保护的运行环境设置 FEISOU_API_KEY：
FEISOU_API_KEY=<你的 API Key，仅在本地配置>
不要把真实 Key 发到聊天、截图或提交进 Git。确认助手进程能够读取该环境变量后，再请求它“用飞搜查找 AI 编程入门资料”。具体安装路径由所用助手决定。
API 文档
搜索接口
GET https://feisou.app/api/skill/search?key=YOUR_KEY&q=搜索关键词&limit=20
| 参数 | 必填 | 说明 |
|---|---|---|
key | 是 | API Key（fs_ 开头） |
q | 是 | 非空搜索词，支持中英文 |
limit | 否 | 结果数量参数，默认 20；建议使用正整数，实际返回可能更少 |
响应字段
query 是查询词，total 是本次返回数量，results 是结果数组，elapsed 是耗时（秒）。有结果时还会返回 keywords。
每条结果包含 title、url、snippet、kb_name、relevance_score 和 ai_summary。部分文本字段可能为空；相关性分数用于结果排序，不是事实正确率。
usage 返回当前额度信息，包括 free_remaining、paid_remaining 和 total_remaining。不要将它解析为旧版的 used / limit 结构。
查询用量
GET https://feisou.app/api/skill/usage?key=YOUR_KEY
用量接口返回 usage、limit、quota 和 active；其中 quota 包含剩余额度。账户额度以接口和控制台显示为准。
错误码
| 状态码 | 说明 |
|---|---|
401 | 无效或已停用的 API Key |
429 | 可用搜索额度不足（响应体包含额度信息） |
422 | 缺少必填参数、搜索词为空或参数类型错误 |
503 | 服务暂时不可用，稍后重试 |
500 | 服务端错误 |
调用示例
curl -G "https://feisou.app/api/skill/search" \
--data-urlencode "key=${FEISOU_API_KEY}" \
--data-urlencode "q=小红书运营"
以上命令从本地环境变量读取 Key。当前接口通过查询参数接收 Key，请勿将带真实 Key 的请求链接分享、截图或粘贴进浏览器；关闭客户端的完整请求 URL 日志。可用次数和付费余额请在控制台查看。
飞书应用版
在飞书中直接使用飞搜，无需离开工作区。支持对话式搜索、AI 智能摘要。
安装方式
点击链接安装：https://applink.feishu.cn/T95srBggA9Bb
或用飞书扫描二维码：
如果提示"没有权限"，
按飞书页面提示申请使用；是否可用取决于应用及组织权限，申请不等于已获授权。