Build with Argosor

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query or keyword phrase to inspect in real time (e.g., \"best seo api for ai agents\")."
    },
    "engine": {
      "type": "string",
      "enum": [
        "google",
        "bing",
        "duckduckgo",
        "google_news",
        "google_ai_overview"
      ],
      "description": "Target search engine vertical to query. Defaults to \"google\"."
    },
    "country": {
      "type": "string",
      "description": "Two-letter ISO 3166-1 alpha-2 country code for localized geo-targeting (e.g., \"us\", \"gb\", \"de\", \"es\"). Defaults to \"us\"."
    },
    "language": {
      "type": "string",
      "description": "Two-letter ISO 639-1 language code for SERP localization (e.g., \"en\", \"es\", \"fr\"). Defaults to \"en\"."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 30,
      "description": "Maximum number of organic SERP results to return (1 to 30). Defaults to 10."
    },
    "includeAiOverview": {
      "type": "boolean",
      "description": "When true, extracts Google AI Overview / generative summary and cited source URLs. Defaults to true."
    },
    "includePeopleAlsoAsk": {
      "type": "boolean",
      "description": "When true, extracts People Also Ask (PAA) questions and answer snippets. Defaults to true."
    },
    "executionMode": {
      "type": "string",
      "enum": [
        "managed",
        "byok"
      ],
      "description": "Execution mode: \"managed\" ($0.0005/query via Argosor Global Edge) or \"byok\" ($0 markup using encrypted vault credentials). Defaults to \"managed\"."
    }
  }
}

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "brandName",
    "domain"
  ],
  "properties": {
    "brandName": {
      "type": "string",
      "description": "Target brand or product name to audit across generative engines (e.g., \"Argosor\")."
    },
    "domain": {
      "type": "string",
      "description": "Primary canonical domain of the brand being audited (e.g., \"argosor.com\")."
    },
    "promptTopic": {
      "type": "string",
      "description": "High-intent buyer prompt or category topic to evaluate Share-of-Voice for (e.g., \"best seo and geo api for ai agents\")."
    },
    "competitors": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Competitor domain name (e.g., \"dataforseo.com\", \"serpapi.com\")."
      },
      "description": "Optional list of competitor domains to benchmark citation displacement against."
    },
    "llmEngines": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "chatgpt_search",
          "perplexity",
          "claude",
          "google_ai_overviews",
          "google_ai_mode",
          "gemini",
          "grok",
          "deepseek",
          "copilot",
          "meta_ai"
        ],
        "description": "Identifier of the generative AI search engine to audit."
      },
      "description": "Optional subset of the 9 generative AI engines to include in the Share-of-Voice audit."
    },
    "forceRefresh": {
      "type": "boolean",
      "description": "When true, bypasses the 6-hour response deduplication cache and forces a fresh multi-engine audit. Defaults to false."
    }
  }
}

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Full URL or domain to crawl and audit (e.g., \"https://argosor.com\")."
    },
    "checkAiCrawlers": {
      "type": "boolean",
      "description": "When true, fetches /robots.txt on the target origin to verify whether GPTBot, ClaudeBot, and PerplexityBot are permitted. Defaults to true."
    },
    "checkLlmsTxt": {
      "type": "boolean",
      "description": "When true, probes /llms.txt on the target origin for machine-readable agent documentation. Defaults to true."
    },
    "checkSchemaOrg": {
      "type": "boolean",
      "description": "When true, parses and counts embedded application/ld+json Schema.org blocks. Defaults to true."
    }
  }
}

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "seedTopic"
  ],
  "properties": {
    "seedTopic": {
      "type": "string",
      "description": "Core seed keyword or product category to expand into semantic intent clusters (e.g., \"generative engine optimization api\")."
    },
    "country": {
      "type": "string",
      "description": "Two-letter ISO country code for search volume and CPC calibration (e.g., \"us\", \"gb\"). Defaults to \"us\"."
    },
    "language": {
      "type": "string",
      "description": "Two-letter ISO language code for keyword generation (e.g., \"en\"). Defaults to \"en\"."
    },
    "maxClusters": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "Maximum number of semantic topic clusters to generate (1 to 10). Defaults to 4."
    }
  }
}

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "domain"
  ],
  "properties": {
    "domain": {
      "type": "string",
      "description": "Target root domain or hostname to analyze (e.g., \"argosor.com\")."
    },
    "includeAnchorDistribution": {
      "type": "boolean",
      "description": "When true, includes categorized anchor text percentage breakdown. Defaults to true."
    },
    "includeLlmCitedPages": {
      "type": "boolean",
      "description": "When true, includes the top URLs on the domain most frequently cited by Perplexity, ChatGPT Search, and Claude. Defaults to true."
    }
  }
}

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Full HTTP/HTTPS web page URL to fetch and convert into clean Markdown."
    },
    "includeLinks": {
      "type": "boolean",
      "description": "When true, extracts a structured list of outbound and internal anchor links from the page. Defaults to true."
    },
    "includeMetadata": {
      "type": "boolean",
      "description": "When true, includes title, word count, estimated LLM token count, and SHA-256 content digest. Defaults to true."
    },
    "maxCharacters": {
      "type": "integer",
      "minimum": 500,
      "maximum": 100000,
      "description": "Maximum character length of the returned Markdown document (500 to 100,000). Defaults to 16000."
    }
  }
}

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "primaryDomain",
    "competitorDomains"
  ],
  "properties": {
    "primaryDomain": {
      "type": "string",
      "description": "Your primary domain to benchmark (e.g., \"argosor.com\")."
    },
    "competitorDomains": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Competitor root domain (e.g., \"dataforseo.com\", \"serpapi.com\", \"ahrefs.com\", \"firecrawl.dev\")."
      },
      "description": "Array of 1 to 5 competitor domains to compare against the primary domain."
    },
    "focusVertical": {
      "type": "string",
      "description": "Optional market vertical or product category description for tailored gap prioritization."
    }
  }
}

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "entityType",
    "name",
    "url",
    "description"
  ],
  "properties": {
    "entityType": {
      "type": "string",
      "enum": [
        "SoftwareApplication",
        "Organization",
        "FAQPage",
        "Article",
        "Product",
        "WebSite"
      ],
      "description": "Primary Schema.org entity type to generate."
    },
    "name": {
      "type": "string",
      "description": "Canonical brand, product, or article title (e.g., \"Argosor\")."
    },
    "url": {
      "type": "string",
      "description": "Canonical URL for the entity (e.g., \"https://argosor.com\")."
    },
    "description": {
      "type": "string",
      "description": "Concise factual summary of the entity optimized for search snippets and LLM citations."
    },
    "pricingOffers": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "name",
          "priceUsd"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Plan or offer tier name (e.g., \"Starter Plan\")."
          },
          "priceUsd": {
            "type": "number",
            "description": "Monthly or unit price in USD (e.g., 19)."
          }
        }
      },
      "description": "Optional array of pricing tiers to embed as Schema.org Offer nodes."
    },
    "faqItems": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "question",
          "answer"
        ],
        "properties": {
          "question": {
            "type": "string",
            "description": "Frequently asked question text."
          },
          "answer": {
            "type": "string",
            "description": "Authoritative answer text."
          }
        }
      },
      "description": "Optional FAQ items to embed as a linked Schema.org FAQPage node."
    }
  }
}

{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "email": {
      "type": "string",
      "description": "Optional developer or agent owner email address. If omitted, provisions an instant claimable sandbox identity."
    },
    "name": {
      "type": "string",
      "description": "Optional display name for the developer or autonomous agent."
    },
    "workspaceName": {
      "type": "string",
      "description": "Optional workspace name (e.g., \"Acme Growth & GEO Agent\")."
    }
  }
}

{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "includeApiKeys": {
      "type": "boolean",
      "description": "When true, lists active API keys belonging to the workspace. Defaults to true."
    },
    "includeByokVault": {
      "type": "boolean",
      "description": "When true, lists encrypted BYOK provider credentials (DataForSEO, SerpApi, Ahrefs, Firecrawl, OpenAI, Perplexity) configured in the workspace vault. Defaults to true."
    }
  }
}

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "plan"
  ],
  "properties": {
    "plan": {
      "type": "string",
      "enum": [
        "starter",
        "builder",
        "scale"
      ],
      "description": "Target Argosor subscription plan tier: \"starter\" ($19/mo), \"builder\" ($39/mo), or \"scale\" ($79/mo)."
    },
    "successUrl": {
      "type": "string",
      "description": "Optional redirect URL after completed Stripe Checkout payment."
    },
    "cancelUrl": {
      "type": "string",
      "description": "Optional redirect URL if checkout is canceled."
    }
  }
}

{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "windowHours": {
      "type": "integer",
      "minimum": 1,
      "maximum": 720,
      "description": "Lookback time window in hours (1 to 720). Defaults to 24."
    },
    "limit": {
      "type": "integer",
      "minimum": 5,
      "maximum": 100,
      "description": "Maximum number of recent live events to include (5 to 100). Defaults to 25."
    }
  }
}

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "brandName",
    "domain",
    "targetPrompt"
  ],
  "properties": {
    "brandName": {
      "type": "string",
      "description": "Brand or product name to evaluate and write Answer-First GEO content for (e.g., \"Argosor\")."
    },
    "domain": {
      "type": "string",
      "description": "Primary canonical domain of the brand (e.g., \"argosor.com\")."
    },
    "targetPrompt": {
      "type": "string",
      "description": "High-intent buyer prompt or topic to optimize citation capture for (e.g., \"best enterprise seo and geo mcp server\")."
    },
    "targetUrl": {
      "type": "string",
      "description": "Optional specific page URL being optimized (defaults to https://<domain>)."
    },
    "competitors": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Competitor root domain (e.g., \"llmpulse.ai\", \"dataforseo.com\")."
      },
      "description": "Optional list of up to 4 competitor domains for the generated Answer-First comparison table."
    },
    "forceRefresh": {
      "type": "boolean",
      "description": "When true, bypasses the 6-hour response deduplication cache. Defaults to false."
    }
  }
}

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "domain"
  ],
  "properties": {
    "domain": {
      "type": "string",
      "description": "Target root domain to audit AI crawler taxonomy and generate analytics attribution filters for (e.g., \"argosor.com\")."
    },
    "analyticsPlatform": {
      "type": "string",
      "enum": [
        "all",
        "ga4",
        "plausible",
        "posthog"
      ],
      "description": "Target analytics platform for attribution snippets. Defaults to \"all\"."
    }
  }
}

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "action",
    "domain"
  ],
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "save_project_context",
        "track_keywords_rank",
        "gsc_performance_sync",
        "stage_rewrite_for_approval",
        "approve_and_publish",
        "rollback_change",
        "list_action_board",
        "update_action_board_item"
      ],
      "description": "Autopilot operation to execute: manage project memory, run weekly rank decay checks, stage/approve/rollback CMS rewrites, or list/update the Shared Action Board."
    },
    "domain": {
      "type": "string",
      "description": "Target project domain (e.g., \"argosor.com\")."
    },
    "brandName": {
      "type": "string",
      "description": "Optional brand display name for project memory and Answer-First rewrite staging."
    },
    "brandVoiceGuidelines": {
      "type": "string",
      "description": "Optional brand voice and tone guidelines stored in persistent project memory."
    },
    "cmsPlatform": {
      "type": "string",
      "enum": [
        "wordpress",
        "github_pr_nextjs_astro",
        "webflow",
        "ghost",
        "shopify",
        "custom_webhook"
      ],
      "description": "Target CMS or Git deployment target for staged rewrites and 1-click rollbacks. Defaults to \"github_pr_nextjs_astro\"."
    },
    "keywords": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Target keyword phrase to track."
      },
      "description": "Optional list of target keywords to save or check for 3+ position decay."
    },
    "targetUrl": {
      "type": "string",
      "description": "Target page URL when staging an Answer-First SEO/GEO rewrite for human approval."
    },
    "targetKeyword": {
      "type": "string",
      "description": "Primary keyword when staging a page rewrite."
    },
    "changeId": {
      "type": "string",
      "description": "Staged change ID when calling approve_and_publish or rollback_change."
    },
    "actionItemId": {
      "type": "string",
      "description": "Action Board item ID when calling update_action_board_item."
    },
    "owner": {
      "type": "string",
      "enum": [
        "Chief of SEO",
        "Analyst",
        "Writer",
        "Refresher"
      ],
      "description": "Specialist agent owner on the Shared Action Board."
    },
    "status": {
      "type": "string",
      "enum": [
        "Todo",
        "Working",
        "Blocked",
        "Ready for review",
        "Done"
      ],
      "description": "Workflow status on the Shared Action Board. Night routines automatically cap status at \"Ready for review\"."
    },
    "expectedClicks": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000,
      "description": "Estimated monthly organic + AI click gain used to sort the Shared Action Board descending."
    },
    "nightRoutine": {
      "type": "boolean",
      "description": "When true, enforces the night routine guardrail so items stop at \"Ready for review\" (requires_human_approval: true)."
    }
  }
}