iFlow Search

Web search, image search, and webpage content fetch via the iFlow Search API. / 通过 iFlow Search API 提供网页搜索、图片搜索和网页内容抓取能力。

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

Script	Purpose	Required args
scripts/web_search.sh <keywords> [num]	Web search	keywords
scripts/image_search.sh <keywords> [num]	Image search	keywords
scripts/web_fetch.sh <url>	Fetch + clean a URL	url

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：服务端异常，稍后重试