AEO Research

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "prompt",
    "url",
    "perplexityApiKey"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "The site URL to check for citations."
    },
    "prompt": {
      "type": "string",
      "minLength": 1,
      "description": "The end-user question to test."
    },
    "perplexityApiKey": {
      "type": "string",
      "minLength": 1,
      "description": "Your Perplexity API key (BYOK). Request-scoped; never stored or logged."
    }
  },
  "additionalProperties": false
}

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

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "prompt",
    "urls",
    "perplexityApiKey"
  ],
  "properties": {
    "urls": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri"
      },
      "minItems": 2,
      "description": "Two or more competitor URLs to rank."
    },
    "prompt": {
      "type": "string",
      "minLength": 1
    },
    "perplexityApiKey": {
      "type": "string",
      "minLength": 1,
      "description": "Your Perplexity API key (BYOK). Request-scoped; never stored or logged."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "url",
    "topic",
    "perplexityApiKey"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri"
    },
    "topic": {
      "type": "string",
      "minLength": 1,
      "description": "The topic / niche to generate prompts for."
    },
    "testCount": {
      "type": "integer",
      "maximum": 10,
      "minimum": 0,
      "description": "How many generated prompts to live-test (default 3)."
    },
    "perplexityApiKey": {
      "type": "string",
      "minLength": 1,
      "description": "Your Perplexity API key (BYOK). Request-scoped; never stored or logged."
    }
  },
  "additionalProperties": false
}

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

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

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

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

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

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "url",
    "prompts",
    "perplexityApiKey"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri"
    },
    "prompts": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "minItems": 1,
      "description": "Prompts to test for visibility."
    },
    "perplexityApiKey": {
      "type": "string",
      "minLength": 1,
      "description": "Your Perplexity API key (BYOK). Request-scoped; never stored or logged."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "url",
    "targetDomain"
  ],
  "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)."
    }
  },
  "additionalProperties": false
}