bing_url_inspection

Instructions

Implementation Reference

• src/tools/bing/url-inspection.ts:27-71 (handler)

  The main tool handler that calls the Bing API GetUrlInfo endpoint, formats the response into a human-readable text output with indexing status, crawl info, link counts, redirects, and mobile status.

  export const bingUrlInspection: ToolDefinition<typeof schema> = {
    name: "bing_url_inspection",
    description:
      "Inspect a URL's indexing and crawl status in Bing Webmaster Tools. Returns HTTP status, indexing state, crawl date, page title, link counts, and whether the URL is blocked.",
    schema,
    handler: async (args, config) => {
      const apiKey = getBingApiKey();
  
      const siteUrl = args.site_url ?? config.bing?.default_site;
      if (!siteUrl) {
        throw new Error(
          "site_url is required. Pass it as an argument or set bing.default_site in ~/.seo-mcp/config.json"
        );
      }
  
      const data = (await bingGet("GetUrlInfo", { siteUrl, url: args.url }, apiKey)) as BingUrlInfo | null;
  
      if (!data) {
        return { content: [{ type: "text", text: `No data found for URL: ${args.url}` }] };
      }
  
      const lines: string[] = [
        `URL: ${args.url}`,
        `HTTP status: ${data.HttpStatusCode ?? "—"}`,
        `Indexed: ${data.IsIndexed ? "Yes" : "No"}`,
        `Blocked: ${data.IsBlocked ? "Yes" : "No"}`,
        `Blocked by robots.txt: ${data.IsBlockedByRobotsTxt ? "Yes" : "No"}`,
        `Last crawled: ${data.CrawlTime ?? "—"}`,
        `Title: ${data.Title ?? "—"}`,
        `Content length: ${data.ContentLength ? `${data.ContentLength} bytes` : "—"}`,
        `Internal links: ${data.InternalLinkCount ?? "—"}`,
        `External links: ${data.ExternalLinkCount ?? "—"}`,
        `Parameter URL: ${data.IsParamUrl ? "Yes" : "No"}`,
      ];
  
      if (data.RedirectTo) {
        lines.push(`Redirects to: ${data.RedirectTo}`);
      }
      if (data.MobileStatus) {
        lines.push(`Mobile status: ${data.MobileStatus}`);
      }
  
      return { content: [{ type: "text", text: lines.join("\n") }] };
    },
  };

• src/tools/bing/url-inspection.ts:20-25 (schema)

  Zod schema defining the input parameters: required 'url' and optional 'site_url'.

  const schema = z.object({
    url: z.string().describe("The exact URL to inspect."),
    site_url: z.string().optional().describe(
      "Your site URL in Bing Webmaster Tools, e.g. 'https://example.com/'. Uses config default if omitted."
    ),
  });

• src/tools/bing/index.ts:7-12 (registration)

  Registration of bing_url_inspection in the bingTools array alongside other Bing tools.

  export const bingTools: ToolDefinition[] = [
    bingKeywordResearch as unknown as ToolDefinition,
    bingCrawlHealth as unknown as ToolDefinition,
    bingUrlInspection as unknown as ToolDefinition,
    bingSitemapList as unknown as ToolDefinition,
  ];