AdsCrawl for Mastra

SETUP METHOD 01

Define a Mastra tool

Combine createTool, Zod schemas and the AdsCrawl JavaScript SDK. Test the tool before attaching a model.

1. 1

   Install dependencies

   Run this in your application directory.

   ShellCopy

   npm install adscrawl @mastra/core zod

2. 2

   Configure your API key

   Set the variables in your server environment or local shell. Replace the placeholders with your own keys; keep them out of browser bundles and source control.

   ShellCopy

   export ADSCRAWL_API_KEY="your_adscrawl_api_key"

3. 3

   Save mastra-web.mjs

   The execute handler receives the validated input directly. This standalone example invokes the tool and prints its structured result.

   JavaScriptCopy

   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

   Run and connect the next step

   Expect an object with source and Markdown headed Example Domain. Add readWebPage to your Mastra agent’s tools object, for example tools: { readWebPage }, and configure the agent’s model separately.

   ShellCopy

   node mastra-web.mjs