saasusDocsContentTool

Instructions

Implementation Reference

• src/mastra/tools/saasus-content-tool.ts:27-111 (handler)

  The core logic that fetches and parses SaaSus documentation pages. It validates the URL (must be docs.saasus.io), fetches the HTML, extracts the title via regex, uses JSDOM to parse the DOM, selects the main article element (trying article.markdown, article, then main), removes unwanted nav elements, and converts the HTML to Markdown using TurndownService with anchor link removal.

  const fetchSaaSusDocsContent = async (
    url: string
  ): Promise<{ url: string; title: string; content: string }> => {
    if (!url) {
      throw new Error("URL is required");
    }
  
    // Ensure URL is a SaaSus Platform docs URL for security
    if (!url.startsWith("https://docs.saasus.io")) {
      throw new Error("URL must be a SaaSus Platform documentation URL");
    }
  
    const response = await fetch(url);
    if (!response.ok) {
      throw new Error(
        `HTTP ${response.status}: Failed to fetch content from ${url}`
      );
    }
  
    const html = await response.text();
  
    // Extract title from HTML
    const titleMatch = html.match(/<title[^>]*>([^<]*)<\/title>/i);
    const title = titleMatch ? titleMatch[1].replace(/\s+/g, " ").trim() : "";
  
    // Parse HTML with DOM to extract clean content
    const dom = new JSDOM(html);
    const document = dom.window.document;
  
    // Find the main article content
    let articleElement = document.querySelector("article.markdown");
    if (!articleElement) {
      articleElement = document.querySelector("article");
    }
    if (!articleElement) {
      articleElement = document.querySelector("main");
    }
  
    if (!articleElement) {
      throw new Error("Could not find article content");
    }
  
    // Remove unwanted elements using DOM manipulation
    const unwantedSelectors = [
      "nav", // Navigation elements
      "ul:first-child", // First ul is likely breadcrumb/navigation
    ];
  
    unwantedSelectors.forEach((selector) => {
      const elements = articleElement!.querySelectorAll(selector);
      elements.forEach((el) => el.remove());
    });
  
    // Convert to Markdown with enhanced settings
    const turndownService = new TurndownService({
      headingStyle: "atx",
      codeBlockStyle: "fenced",
      bulletListMarker: "-",
      emDelimiter: "*",
      strongDelimiter: "**",
    });
  
    // Add rule to remove anchor links
    turndownService.addRule("removeAnchorLinks", {
      filter: function (node: any) {
        return (
          node.nodeName === "A" && node.getAttribute("href")?.startsWith("#")
        );
      },
      replacement: function () {
        return "";
      },
    });
  
    const content = turndownService
      .turndown(articleElement.innerHTML)
      .replace(/\n{3,}/g, "\n\n") // Normalize line breaks
      .trim();
  
    return {
      url,
      title,
      content,
    };
  };

• src/mastra/tools/saasus-content-tool.ts:10-16 (schema)

  Input schema using Zod: expects a single `url` string parameter describing the SaaSus docs article URL to fetch.

  inputSchema: z.object({
    url: z
      .string()
      .describe(
        "The URL of the SaaSus Platform documentation article to fetch"
      ),
  }),

• src/mastra/tools/saasus-content-tool.ts:17-21 (schema)

  Output schema using Zod: returns an object with `url` (string), `title` (string), and `content` (string).

  outputSchema: z.object({
    url: z.string(),
    title: z.string(),
    content: z.string(),
  }),

• src/mastra/mcp/saasus-platform-docs-search-mcp.ts:7-15 (registration)

  The tool is registered on the MCPServer named 'SaaSus Platform Docs Search' along with saasusDocsSearchTool and saasusDocsSitemapTool.

  export const mcpServer = new MCPServer({
    name: "SaaSus Platform Docs Search",
    version: packageJson.version,
    tools: {
      saasusDocsSearchTool,
      saasusDocsContentTool,
      saasusDocsSitemapTool,
    },
  });