iFlow Search

Summary

iFlow Search is a community skill that exposes the iFlow Search API as three callable scripts inside an agent:

• Web Search — keyword search over the iFlow web index, returning title / snippet / link
• Image Search — keyword image search, returning image URL, source page, and title
• Web Fetch — convert a URL into LLM-friendly text content

Use Cases

• Pull fresh web results for topics past the model's training cutoff
• Search for images by keyword (reference shots, product images, screenshots)
• Read a known URL as cleaned markdown for downstream summarization
• Chain web search → choose links → fetch each to build a small research dossier

Requirements

• bash and curl available in PATH
• IFLOW_API_KEY exported in the shell that launches the agent

Setup

1. Create an API key at https://platform.iflow.cn/profile?tab=apiKey
2. Export it in your shell before starting the agent:

echo 'export IFLOW_API_KEY="YOUR_IFLOW_API_KEY"' >> ~/.zshrc
source ~/.zshrc

Do not pass the key as a CLI argument. Do not commit the key to any file.

Capabilities

See the Chinese section below for full parameter docs, examples, and error codes.

心流搜索 Skill

概述

心流搜索 Skill 是一个联网搜索技能，基于心流搜索 API，提供三大核心能力：

• 网页搜索：根据关键词搜索网络，返回相关网页的标题、摘要和链接
• 图片搜索：根据关键词搜索图片，返回图片 URL 和来源
• 网页内容抓取：将指定 URL 的网页转换为大模型友好的文本内容

使用场景

• 用户需要搜索最新的网络信息
• 用户需要查找特定主题的图片
• 用户提供了一个 URL，需要获取网页内容进行分析
• 用户需要综合多个网页的信息来回答问题

能力说明

1. 网页搜索 (webSearch)

搜索网络并返回结构化的搜索结果。

调用脚本：scripts/web_search.sh

参数：

• keywords（必填）：搜索关键词
• num（可选，默认 10）：返回结果数量

返回结果：每条结果包含 title（标题）、snippet（摘要）、link（链接）

使用示例：

# 搜索 Python 异步编程教程
bash scripts/web_search.sh "Python 异步编程教程" 10

2. 图片搜索 (imageSearch)

搜索图片并返回图片链接。

调用脚本：scripts/image_search.sh

参数：

• keywords（必填）：搜索关键词
• num（可选，默认 10）：返回结果数量

返回结果：每条结果包含 url（图片 URL）、refUrl（来源页面）、title（图片标题，可能为空）

使用示例：

# 搜索风景图片
bash scripts/image_search.sh "风景壁纸" 5

3. 网页内容抓取 (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 环境变量才能使用。请按以下步骤操作：

1. 访问 https://platform.iflow.cn 注册并获取 API Key
2. 将 API Key 写入 shell 配置文件以持久生效：echo 'export IFLOW_API_KEY=your_api_key' >> ~/.zshrc
3. 在当前终端执行 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 异步编程，找一篇好的教程详细看看」

1. 先用网页搜索找到相关结果：

bash scripts/web_search.sh "Python 异步编程 教程" 10

2. 从搜索结果中挑选合适的链接，用网页抓取获取详细内容：

bash scripts/web_fetch.sh "从搜索结果中获取的链接"

最佳实践

1. 先搜索，再抓取：先用 webSearch 找到相关网页，再用 webFetch 获取详细内容
2. 精炼关键词：使用具体、明确的关键词以获得更精准的搜索结果
3. 控制结果数量：根据需要设置 num 参数，避免请求过多无用结果

错误处理

• PARAM_INVALID：检查请求参数是否正确
• INVALID_APIKEY：检查 API Key 是否有效
• USER_RATE_LIMIT：降低请求频率，限制为 1000 RPM
• SYSTEM_ERROR：服务端异常，稍后重试