SecretAgent 2.0 === Hero

:bell: SecretAgent 2.0 被命名为“Hero”，目前处于 Alpha 测试阶段。我们已准备好让开发者开始迁移——迁移过程相当简单（迁移指南）。您可以通过 这里 关注 Hero 的开发进展，或查看最新的 npm 包 @ulixee/hero-playground。

---

SecretAgent

SecretAgent 是一款专为网页抓取而构建的浏览器。

• 专为抓取设计——它是首款现代无头浏览器，专门针对抓取任务而非单纯的自动化测试而设计。
• 面向 Web 开发者——我们在 Node.js 中直接重现了一个完全符合标准的 DOM，让您无需再为以往的抓取工具所困扰。
• 基于 Chrome 内核——强大的 Chrome 引擎作为其核心，带来闪电般的渲染速度。
• 可模拟任何现代浏览器——通过浏览器模拟器，您可以轻松地将您的脚本伪装成几乎任何浏览器。
• 全栈规避检测——避免因网络栈中的 TLS 指纹而导致被封禁。

更多详情请访问我们的 官网。

安装

npm i --save secret-agent

或者

yarn add secret-agent

使用

SecretAgent 提供对 W3C DOM 规范的直接访问，无需像 Puppeteer 那样使用复杂的 evaluate 回调和多上下文切换：

const agent = require('secret-agent');

(async () => {
  await agent.goto('https://example.org');
  const title = await agent.document.title;
  const intro = await agent.document.querySelector('p').textContent;
  await agent.close();
})();

浏览完整的 API 文档。

参与贡献

我们非常欢迎您的帮助，共同让 SecretAgent 成为更优秀的工具。请随时提交 Pull Request。

许可证

MIT

SecretAgent 快速上手指南

SecretAgent 是一款专为网页抓取（Scraping）打造的现代无头浏览器。它基于 Chrome 引擎，直接在 Node.js 中提供完全合规的 DOM 环境，无需像 Puppeteer 那样处理复杂的上下文切换，能有效规避 TLS 指纹检测并模拟各类主流浏览器。

注意：SecretAgent 2.0 已更名为 Hero 并处于 Alpha 测试阶段。新项目建议关注 Hero 的迁移指南，本指南基于当前稳定的 SecretAgent 版本。

环境准备

• 操作系统：Windows、macOS 或 Linux
• 运行时：Node.js (建议 v14 及以上版本)
• 包管理器：npm 或 yarn

安装步骤

使用 npm 安装：

npm i --save secret-agent

或使用 yarn 安装：

yarn add secret-agent

💡 国内加速提示：若下载缓慢，可配置淘宝镜像源： npm config set registry https://registry.npmmirror.com

基本使用

SecretAgent 允许你直接通过 W3C DOM 标准操作页面，代码简洁直观。以下是最简单的抓取示例：

const agent = require('secret-agent');

(async () => {
  await agent.goto('https://example.org');
  const title = await agent.document.title;
  const intro = await agent.document.querySelector('p').textContent;
  
  console.log('标题:', title);
  console.log('内容:', intro);
  
  await agent.close();
})();

更多详细 API 文档请访问：SecretAgent Docs