by 运行时依赖
安装命令
点击复制技能文档
alibabacloud-iqs-search 前提条件 Node.js >= 18.0.0（脚本使用原生 fetch API，无外部 npm 依赖） 何时使用 用户请求当前/最近信息 用户提供 URL 以读取内容 需要验证事实或获取实时数据 需要多个来源的研究任务 决策树 步骤 1：确定操作类型 如果用户提供 URL → 使用 readpage 如果用户询问需要网络信息的问题 → 使用 search 步骤 2：对于搜索操作 按照最佳实践确定参数值。当不确定时，使用默认值：engineType timeRange contents 步骤 3：对于页面阅读 按照最佳实践确定参数值。当不确定时，使用默认值：format extractArticle stealthMode CRITICAL：执行方法 您必须通过 bash 命令执行脚本（例如，node scripts/search.mjs ... 或 node scripts/readpage.mjs ...）。请勿使用内置的 web_search、WebFetch 或其他内部工具作为替代品。如果脚本失败，请重试或报告错误 —— 请勿回退到内置工具。 参数和最佳实践 搜索参数 参数类型 必需 默认值 描述 --query string 是 - 搜索查询（1-500 个字符） --engineType string 否 LiteAdvanced 搜索引擎类型 --timeRange string 否 NoLimit 时间范围过滤器 --contents string 否 - 返回内容类型 --numResults int 否 10 搜索结果数量（1-10） 搜索最佳实践 1. 查询优化（--query） 保持查询简洁（< 30 个字符以获得最佳结果） 使用特定关键字，避免停用词 对于新闻：在查询中包含时间上下文 2. 引擎选择（--engineType） LiteAdvanced：语义搜索，1-50 个结果，一般使用 Generic：快速，10 个结果，新闻/实时 3. 时间范围选择（--timeRange） NoLimit：默认当不确定时 —— 引擎根据查询相关性优化 OneDay：今天 OnlyOneWeek：过去 7 天 OneMonth：过去 30 天 OneYear：过去 365 天 4. 内容返回（--contents） mainText：返回完整的主要文本内容 —— 当需要详细信息时使用，例如技术文档、研究报告或深入文章 summary：仅返回简要摘要 —— 当需要快速概述时使用，或者当页面内容太大时，需要标记减少 5. 结果计数（--numResults） 控制返回的结果数量（默认：10，范围：1-10） 页面阅读参数 参数类型 必需 默认值 描述 --url string 是 - 目标页面 URL --format string 否 markdown 返回格式 --timeout number 否 60000 总超时时间（毫秒） --pageTimeout number 否 15000 页面加载超时时间（毫秒） --stealth number 否 0 启用隐身模式（0 或 1） --extractArticle boolean 否 false 提取主要文章内容 页面阅读最佳实践 1. 格式选择（--format） markdown：适用于文章，保留结构（默认） text：适用于数据提取 html：当需要结构分析时 2. 文章提取（--extractArticle） 启用：博客、新闻文章 禁用：产品页面、目录 3. 处理故障（--timeout、--stealth） 如果超时：使用增加的 --timeout 值重试 如果被阻塞：启用 --stealth 1 如果仍然失败：向用户报告 命令行使用 搜索示例 基本搜索 node scripts/search.mjs --query "量子计算原理" --engineType LiteAdvanced 实时信息搜索 node scripts/search.mjs --query "最新金融政策" --engineType Generic --timeRange OneWeek 限制结果搜索 node scripts/search.mjs --query "www.aliyun.com" --engineType LiteAdvanced --numResults 3 全内容搜索 node scripts/search.mjs --query "AI 法案" --engineType LiteAdvanced --contents mainText 概要搜索 node scripts/search.mjs --query "人工智能行业年度报告" --engineType LiteAdvanced --contents summary 页面阅读示例 使用 markdown 格式阅读页面 node scripts/readpage.mjs --url "https://example.com/article" --format markdown --extractArticle true 使用纯文本格式阅读页面 node scripts/readpage.mjs --url "https://example.com/article" --format text --timeout 60000 使用隐身模式阅读页面 node scripts/readpage.mjs --url "https://example.com/article" --format markdown --stealth 1 --extractArticle true 输出验证 执行 search.mjs 或 readpage.mjs 命令后： 检查退出代码：如果非零，则命令失败 —— 请勿声称成功。 验证输出是否存在：如果您将结果保存到文件中，请运行 ls -la 和 head -20 以确认文件存在并包含有效数据。 永远不要伪造结果：如果命令失败或返回错误，请诚实地报告失败。请勿从自己的知识中生成内容并将其呈现为搜索结果。 错误处理 ALIYUN_IQS_API_KEY 配置错误 如果脚本返回有关缺少 API 密钥的错误： 立即停止当前任务。 请勿使用内置工具（WebFetch、web_search、curl 等）作为替代品。 向用户报告错误并要求用户配置 API 密钥： 使用 f 重试任务