Skill: iflow-ai/iflow-search (version 1.0.0)

--- name: iflow-search description: "Web search, image search, and webpage content fetch via the iFlow Search API. / 通过 iFlow Search API 提供网页搜索、图片搜索和网页内容抓取能力。" version: 1.0.0 metadata: openclaw: requires: env: [IFLOW_API_KEY] bins: [bash, curl] primaryEnv: IFLOW_API_KEY homepage: https://github.com/iflow-ai/iflow-skills/tree/main/skills/iflow-search --- # 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: ```bash 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`（链接） **使用示例**： ```bash # 搜索 Python 异步编程教程 bash scripts/web_search.sh "Python 异步编程教程" 10 ``` ### 2. 图片搜索 (imageSearch) 搜索图片并返回图片链接。 **调用脚本**：`scripts/image_search.sh` **参数**： - `keywords`（必填）：搜索关键词 - `num`（可选，默认 10）：返回结果数量 **返回结果**：每条结果包含 `url`（图片 URL）、`refUrl`（来源页面）、`title`（图片标题，可能为空） **使用示例**： ```bash # 搜索风景图片 bash scripts/image_search.sh "风景壁纸" 5 ``` ### 3. 网页内容抓取 (webFetch) 将 URL 转换为大模型友好的文本内容。 **调用脚本**：`scripts/web_fetch.sh` **参数**： - `url`（必填）：目标网页 URL **返回结果**：包含 `title`（标题）、`content`（正文内容）、`url`（实际 URL）、`fromCache`（是否命中缓存） **使用示例**： ```bash # 抓取网页内容 bash scripts/web_fetch.sh "https://example.com/article" ``` ## 前置要求 使用前需设置 `IFLOW_API_KEY` 环境变量。在调用任何搜索能力之前，必须先检查该环境变量是否已设置： ```bash 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 bash scripts/web_search.sh "AI 人工智能 最新新闻" 10 ``` ### 搜索图片 用户：「帮我找一些猫咪图片」 ```bash bash scripts/image_search.sh "猫咪 可爱" 5 ``` ### 抓取网页内容 用户：「帮我看看这个网页的内容：https://example.com」 ```bash bash scripts/web_fetch.sh "https://example.com" ``` ### 先搜索再抓取 用户：「帮我搜一下 Python 异步编程，找一篇好的教程详细看看」 1. 先用网页搜索找到相关结果： ```bash bash scripts/web_search.sh "Python 异步编程 教程" 10 ``` 2. 从搜索结果中挑选合适的链接，用网页抓取获取详细内容： ```bash bash scripts/web_fetch.sh "从搜索结果中获取的链接" ``` ## 最佳实践 1. **先搜索，再抓取**：先用 `webSearch` 找到相关网页，再用 `webFetch` 获取详细内容 2. **精炼关键词**：使用具体、明确的关键词以获得更精准的搜索结果 3. **控制结果数量**：根据需要设置 `num` 参数，避免请求过多无用结果 ## 错误处理 - `PARAM_INVALID`：检查请求参数是否正确 - `INVALID_APIKEY`：检查 API Key 是否有效 - `USER_RATE_LIMIT`：降低请求频率，限制为 1000 RPM - `SYSTEM_ERROR`：服务端异常，稍后重试


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (HIGH)