在 Mastra 中使用 AdsCrawl

接入方式 01

定义 Mastra 工具

组合 createTool、Zod schema 与 AdsCrawl JavaScript SDK，先验证工具，再连接模型。

1. 1

   安装依赖

   在应用目录中运行以下命令。

   Shell复制

   npm install adscrawl @mastra/core zod

2. 2

   配置 API Key

   在服务端环境或本地终端设置变量，用自己的密钥替换占位符，不要将其放入前端构建产物或提交到代码仓库。

   Shell复制

   export ADSCRAWL_API_KEY="your_adscrawl_api_key"

3. 3

   保存为 mastra-web.mjs

   execute 处理函数直接接收校验后的输入。此独立示例调用工具并打印结构化结果。

   JavaScript复制

   import AdsCrawl from "adscrawl";
   import { createTool } from "@mastra/core/tools";
   import { z } from "zod";
   
   const browser = new AdsCrawl({ apiKey: process.env.ADSCRAWL_API_KEY });
   
   export const readWebPage = createTool({
     id: "read-web-page",
     description: "Read a public web page as browser-rendered Markdown.",
     inputSchema: z.object({ url: z.string().url() }),
     outputSchema: z.object({ source: z.string().url(), markdown: z.string() }),
     execute: async ({ url }) => {
       const markdown = await browser.markdown({
         url, waitUntil: "domcontentloaded",
       });
       if (!markdown.trim()) throw new Error("The page returned no text");
       return { source: url, markdown };
     },
   });
   
   const result = await readWebPage.execute({ url: "https://example.com" }, {});
   console.log(result);

4. 4

   运行并接入下一步

   预期输出包含 source 的对象，以及标题为 Example Domain 的 Markdown。将 readWebPage 加入 Mastra Agent 的 tools 对象，例如 tools: { readWebPage }，并单独配置 Agent 使用的模型。

   Shell复制

   node mastra-web.mjs