iFlow Search 摘要
iFlow Search 是一个社区技能，暴露 iFlow Search API 作为三个可调用脚本在代理中：
Web Search — 关键词搜索 iFlow 网络索引，返回标题 / 摘要 / 链接
Image Search — 关键词图片搜索，返回图片 URL、来源页面和标题
Web Fetch — 将 URL 转换为 LLM 友好的文本内容
使用场景
拉取模型训练截止日期后的新鲜网络结果
按关键词搜索图片（参考截图、产品图片、屏幕截图）
以清洁的 markdown 格式读取已知 URL，以便进行下游摘要
将网络搜索 → 选择链接 → 获取每个链接以构建小型研究文档
要求
bash 和 curl 可用在 PATH 中
IFLOW_API_KEY 导出在启动代理的 shell 中
设置
在 https://platform.iflow.cn/profile?tab=apiKey 创建 API 密钥
在启动代理之前在 shell 中导出它：
echo 'export IFLOW_API_KEY="YOUR_IFLOW_API_KEY"' >> ~/.zshrc
source ~/.zshrc
不要将密钥作为 CLI 参数传递。
不要将密钥提交到任何文件中。
能力
脚本 目的 所需参数
scripts/web_search.sh [num] 网络搜索关键词
scripts/image_search.sh [num] 图片搜索关键词
scripts/web_fetch.sh 获取 + 清洁 URL
请参阅下面的中文部分以获取完整的参数文档、示例和错误代码。
心流搜索 Skill 概述
心流搜索 Skill 是一个联网搜索技能，基于心流搜索 API，提供三大核心能力：
网络搜索：根据关键词搜索网络，返回相关网页的标题、摘要和链接
图片搜索：根据关键词搜索图片，返回图片 URL 和来源
网页内容抓取：将指定 URL 的网页转换为大模型友好的文本内容
使用场景
用户需要搜索最新的网络信息
用户需要查找特定主题的图片
用户提供了一个 URL，需要获取网页内容进行分析
用户需要综合多个网页的信息来回答问题
能力说明
- 网络搜索 (webSearch) 搜索网络并返回结构化的搜索结果。
调用脚本：scripts/web_search.sh
参数：keywords（必填）：搜索关键词 num（可选，默认 10）：返回结果数量
返回结果：每条结果包含 title（标题）、snippet（摘要）、link（链接）
使用示例：
# 搜索 Python 异步编程教程
bash scripts/web_search.sh "Python 异步编程教程" 10
- 图片搜索 (imageSearch) 搜索图片并返回图片链接。
调用脚本：scripts/image_search.sh
参数：keywords（必填）：搜索关键词 num（可选，默认 10）：返回结果数量
返回结果：每条结果包含 url（图片 URL）、refUrl（来源页面）、title（图片标题，可能为空）
使用示例：
# 搜索风景图片
bash scripts/image_search.sh "风景壁纸" 5
- 网页内容抓取 (webFetch) 将 URL 转换为大模型友好的文本内容。
调用脚本：scripts/web_fetch.sh
参数：url（必填）：目标网页 URL
返回结果：包含 title（标题）、content（正文内容）、url（实际 URL）、fromCache（是否命中缓存）
使用示例：
# 抓取网页内容
bash scripts/web_fetch.sh "https://example.com/article"
前置要求
使用前需设置 IFLOW_API_KEY 环境变量。在调用任何搜索能力之前，必须先检查该环境变量是否已设置：
echo "$IFLOW_API_KEY"
如果为空，提示用户：
搜索功能需要设置 IFLOW_API_KEY 环境变量才能使用。请按以下步骤操作：
访问 https://platform.iflow.cn
注册并获取 API Key
将 API Key 写入 shell 配置文件以持久生效：echo 'export IFLOW_API_KEY=your_api_key' >> ~/.zshrc
在当前终端执行 source ~/.zshrc 使其立即生效（否则仅在新打开的终端窗口中才会生效）
设置完成后再继续执行搜索操作。
调用示例
搜索最新新闻
用户：「帮我搜一下最近的 AI 新闻」
bash scripts/web_search.sh "AI 人工智能 最新新闻" 10
搜索图片
用户：「帮我找一些猫咪图片」
bash scripts/image_search.sh "猫咪 可爱" 5
抓取网页内容
用户：「帮我看看这个网页的内容：https://example.com」
bash scripts/web_fetch.sh "https://example.com"
先搜索再抓取
用户：「帮我搜一下 Python 异步编程，找一篇好的教程详细看看」
先用网络搜索找到相关结果：bash scripts/web_search.sh "Python 异步编程 教程" 10
从搜索结果中挑选合适的链接，用网页抓取获取详细内容：bash scripts/web_fetch.sh "从搜索结果中获取的链接"
最佳实践
先搜索，再抓取：先用 webSearch 找到相关网页，再用 webFetch 获取详细内容
精炼关键词：使用具体、明确的关键词以获得更精准的搜索结果
控制结果数量：根据需要设置 num 参数，避免请求过多无用结果
错误处理
PARAM_INVALID：检查请求参数是否正确
INVALID_APIKEY：检查 API Key 是否有效
USER_RATE_LIMIT：降低请求频率，限制为 1000 RPM
SYSTEM_ERROR：服务端异常，稍后重试