AEO Backlink

Find linked and unlinked mentions of a brand across the web via web search results. When a domain is supplied, classifies each mention as linked (on the brand domain) or unlinked (a third-party page — a potential backlink opportunity).

{
  "type": "object",
  "properties": {
    "brand": {
      "type": "string",
      "minLength": 1,
      "description": "Brand or product name to search mentions for."
    },
    "domain": {
      "type": "string",
      "description": "The brand's own domain (e.g. acme.com) — used to classify linked vs unlinked."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Max results (default 20)."
    }
  },
  "required": [
    "brand"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Find guest-post, resource-page, and roundup link-building prospects for a topic by running classic outreach footprints through web search and merging the results by host.

{
  "type": "object",
  "properties": {
    "topic": {
      "type": "string",
      "minLength": 1,
      "description": "Niche or topic to find link-building prospects for."
    },
    "limitPerAngle": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "description": "Max results per outreach angle (default 8)."
    }
  },
  "required": [
    "topic"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Approximate the pages linking to a competitor using free web-search signals (domain mentions and brand mentions). De-duplicates by host and excludes the competitor's own domain. Not a complete backlink index — a free, directional starting point for prospecting.

{
  "type": "object",
  "properties": {
    "competitorUrl": {
      "type": "string",
      "minLength": 1,
      "description": "Competitor's URL or domain (e.g. https://competitor.com or competitor.com)."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 40,
      "description": "Max sources (default 20)."
    }
  },
  "required": [
    "competitorUrl"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Fetch a page and confirm whether it contains a link to the target domain, reporting anchor text and rel attributes (nofollow/sponsored/ugc) and whether the link is dofollow.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "The page URL to inspect."
    },
    "targetDomain": {
      "type": "string",
      "minLength": 1,
      "description": "The domain the link should point to (e.g. yoursite.com)."
    }
  },
  "required": [
    "url",
    "targetDomain"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Fetch a page and extract contact emails (including de-obfuscated and mailto links) and social media handles (Twitter/X, LinkedIn, Facebook, Instagram, GitHub, YouTube).

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "The page URL to extract contact info from."
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Return a Wayback Machine timeline for a URL: total snapshots, first/last archived dates, and a bounded list of snapshot records with direct archive links.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "The URL to look up in the Wayback Machine."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200,
      "description": "Max snapshots to return (default 50)."
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Draft a short, personalized cold outreach email from a contact + context object using your own LLM key (BYOK). Returns a subject line and body. The API key is request-scoped and is never persisted or logged.

{
  "type": "object",
  "properties": {
    "contact": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string"
        },
        "email": {
          "type": "string"
        },
        "site": {
          "type": "string"
        },
        "role": {
          "type": "string"
        }
      },
      "additionalProperties": false,
      "description": "The recipient. All fields optional; more detail yields better personalization."
    },
    "context": {
      "type": "object",
      "properties": {
        "fromBrand": {
          "type": "string",
          "minLength": 1,
          "description": "Your brand or site doing the outreach."
        },
        "fromName": {
          "type": "string",
          "description": "Your name, for the sign-off."
        },
        "reason": {
          "type": "string",
          "minLength": 1,
          "description": "Why you are reaching out (broken link, resource page fit, guest post, etc.)."
        },
        "targetUrl": {
          "type": "string",
          "description": "The page you want linked or featured."
        },
        "notes": {
          "type": "string",
          "description": "Personalization notes to weave in."
        },
        "tone": {
          "type": "string",
          "description": "Desired tone (default: concise, friendly, professional)."
        }
      },
      "required": [
        "fromBrand",
        "reason"
      ],
      "additionalProperties": false,
      "description": "The outreach angle and sender context."
    },
    "provider": {
      "type": "string",
      "enum": [
        "anthropic",
        "openai",
        "groq",
        "perplexity",
        "gateway"
      ],
      "description": "LLM provider for @advance-labs/llm."
    },
    "model": {
      "type": "string",
      "minLength": 1,
      "description": "Model id (e.g. claude-sonnet-4-20250514)."
    },
    "apiKey": {
      "type": "string",
      "minLength": 1,
      "description": "BYOK API key — request-scoped, never persisted or logged."
    },
    "temperature": {
      "type": "number",
      "minimum": 0,
      "maximum": 2
    },
    "maxTokens": {
      "type": "integer",
      "minimum": 1,
      "maximum": 4096
    }
  },
  "required": [
    "contact",
    "context",
    "provider",
    "model",
    "apiKey"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}