{
  "version": "3.6.2",
  "name": "Citedy",
  "description": "Citedy Agent API — SEO content automation, scouting, publishing, and MCP tools",
  "base_url": "https://www.citedy.com",
  "auth": {
    "type": "bearer",
    "header": "Authorization",
    "prefix": "Bearer "
  },
  "actions": [
    {
      "name": "read_llms_txt",
      "description": "Machine-readable site summary for LLM agents (llmstxt.org)",
      "url": "https://www.citedy.com/llms.txt",
      "method": "GET",
      "parameters": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      }
    },
    {
      "name": "read_agent_instructions",
      "description": "Agent runbook: navigation, rules, escalation",
      "url": "https://www.citedy.com/agent-instructions.md",
      "method": "GET",
      "parameters": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      }
    },
    {
      "name": "read_agents_reference",
      "description": "Full Citedy Agent API and MCP reference (agents.md)",
      "url": "https://www.citedy.com/agents.md",
      "method": "GET",
      "parameters": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      }
    },
    {
      "name": "read_mcp_tools",
      "description": "MCP tool catalog with endpoints",
      "url": "https://www.citedy.com/mcp-tools.md",
      "method": "GET",
      "parameters": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      }
    },
    {
      "name": "read_openapi",
      "description": "OpenAPI 3 contract for REST agent endpoints",
      "url": "https://www.citedy.com/openapi/agent-api.openapi.json",
      "method": "GET",
      "parameters": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      }
    },
    {
      "name": "register",
      "description": "Register a new Citedy agent and get approval URL",
      "url": "https://www.citedy.com/api/agent/register",
      "method": "POST",
      "parameters": {
        "type": "object",
        "properties": {
          "agent_name": {
            "type": "string"
          }
        },
        "required": [
          "agent_name"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "health",
      "description": "Public health check (no auth required)",
      "url": "https://www.citedy.com/api/agent/health",
      "method": "GET",
      "parameters": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      }
    },
    {
      "name": "status",
      "description": "Operational readiness status (credits, socials, schedule, knowledge, content)",
      "url": "https://www.citedy.com/api/agent/status",
      "method": "GET",
      "parameters": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      }
    },
    {
      "name": "me",
      "description": "Get balance, limits, connected platforms, referral info, blog URL",
      "url": "https://www.citedy.com/api/agent/me",
      "method": "GET",
      "parameters": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      }
    },
    {
      "name": "rotate_key",
      "description": "Rotate API key (old key invalidated immediately)",
      "url": "https://www.citedy.com/api/agent/rotate-key",
      "method": "POST",
      "parameters": {
        "type": "object",
        "properties": {},
        "additionalProperties": true
      }
    },
    {
      "name": "settings_get",
      "description": "Read agent settings (platforms, tone, trust level, scan sources)",
      "url": "https://www.citedy.com/api/agent/settings",
      "method": "GET",
      "parameters": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      }
    },
    {
      "name": "settings_update",
      "description": "Update agent settings (partial update)",
      "url": "https://www.citedy.com/api/agent/settings",
      "method": "PUT",
      "parameters": {
        "type": "object",
        "properties": {
          "defaultPlatforms": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contentTone": {
            "type": "string"
          },
          "imageStylePreset": {
            "type": "string"
          },
          "trustLevel": {
            "type": "string"
          },
          "scanSources": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "targetTimezone": {
            "type": "string"
          },
          "publishSchedule": {
            "type": "object",
            "properties": {
              "postsPerDay": {
                "type": "integer"
              },
              "slots": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "required": [
              "postsPerDay",
              "slots"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "defaultPlatforms",
          "contentTone",
          "imageStylePreset",
          "trustLevel",
          "scanSources",
          "targetTimezone",
          "publishSchedule"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "image_style",
      "description": "Set illustration style preset (minimal, tech, bold)",
      "url": "https://www.citedy.com/api/agent/image-style",
      "method": "PUT",
      "parameters": {
        "type": "object",
        "properties": {
          "preset": {
            "type": "string"
          }
        },
        "required": [
          "preset"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "personas",
      "description": "List 25 writing personas (slug, name, group, description)",
      "url": "https://www.citedy.com/api/agent/personas",
      "method": "GET",
      "parameters": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      }
    },
    {
      "name": "articles",
      "description": "List generated/published articles",
      "url": "https://www.citedy.com/api/agent/articles",
      "method": "GET",
      "parameters": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      }
    },
    {
      "name": "article_get",
      "description": "Get a single article by id (poll after autopilot generation)",
      "url": "https://www.citedy.com/api/agent/articles/{id}",
      "method": "GET",
      "parameters": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Path parameter: id"
          }
        },
        "required": [
          "id"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "scan",
      "description": "Fast trend scan across X, web, HackerNews, Reddit",
      "url": "https://www.citedy.com/api/agent/scan",
      "method": "POST",
      "parameters": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string"
          },
          "mode": {
            "type": "string"
          },
          "limit": {
            "type": "integer"
          }
        },
        "required": [
          "query",
          "mode",
          "limit"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "post",
      "description": "Create micro social post from topic",
      "url": "https://www.citedy.com/api/agent/post",
      "method": "POST",
      "parameters": {
        "type": "object",
        "properties": {
          "topic": {
            "type": "string"
          },
          "platforms": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "tone": {
            "type": "string"
          },
          "contentType": {
            "type": "string"
          }
        },
        "required": [
          "topic",
          "platforms",
          "tone",
          "contentType"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "publish",
      "description": "Publish or schedule a social adaptation",
      "url": "https://www.citedy.com/api/agent/publish",
      "method": "POST",
      "parameters": {
        "type": "object",
        "properties": {
          "adaptationId": {
            "type": "string"
          },
          "action": {
            "type": "string"
          },
          "platform": {
            "type": "string"
          },
          "accountId": {
            "type": "string"
          }
        },
        "required": [
          "adaptationId",
          "action",
          "platform",
          "accountId"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "publish_raw",
      "description": "Direct publish article as-is to social platform (no AI adaptation, 0 credits)",
      "url": "https://www.citedy.com/api/agent/publish",
      "method": "POST",
      "parameters": {
        "type": "object",
        "properties": {
          "action": {
            "type": "string"
          },
          "articleId": {
            "type": "string"
          },
          "platform": {
            "type": "string"
          },
          "accountId": {
            "type": "string"
          }
        },
        "required": [
          "action",
          "articleId",
          "platform",
          "accountId"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "autopilot",
      "description": "Generate article by topic or source_urls (standard or turbo mode)",
      "url": "https://www.citedy.com/api/agent/autopilot",
      "method": "POST",
      "parameters": {
        "type": "object",
        "properties": {
          "topic": {
            "type": "string"
          },
          "size": {
            "type": "string"
          },
          "mode": {
            "type": "string"
          },
          "language": {
            "type": "string"
          },
          "persona": {
            "type": "string"
          },
          "illustrations": {
            "type": "boolean"
          },
          "audio": {
            "type": "boolean"
          },
          "disable_competition": {
            "type": "boolean"
          },
          "auto_publish": {
            "type": "boolean"
          }
        },
        "required": [
          "topic",
          "size",
          "mode",
          "language",
          "persona",
          "illustrations",
          "audio",
          "disable_competition",
          "auto_publish"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "article_publish",
      "description": "Publish a draft article (status: generated → published)",
      "url": "https://www.citedy.com/api/agent/articles/{id}/publish",
      "method": "POST",
      "parameters": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Path parameter: id"
          }
        },
        "required": [
          "id"
        ],
        "additionalProperties": true
      }
    },
    {
      "name": "article_unpublish",
      "description": "Unpublish a published article (→ draft)",
      "url": "https://www.citedy.com/api/agent/articles/{id}",
      "method": "PATCH",
      "parameters": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Path parameter: id"
          },
          "action": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "action"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "article_delete",
      "description": "Permanently delete an article and associated storage files",
      "url": "https://www.citedy.com/api/agent/articles/{id}",
      "method": "DELETE",
      "parameters": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Path parameter: id"
          }
        },
        "required": [
          "id"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "adapt",
      "description": "Adapt article to social platforms (max 3 per request)",
      "url": "https://www.citedy.com/api/agent/adapt",
      "method": "POST",
      "parameters": {
        "type": "object",
        "properties": {
          "article_id": {
            "type": "string"
          },
          "platforms": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "include_ref_link": {
            "type": "boolean"
          }
        },
        "required": [
          "article_id",
          "platforms",
          "include_ref_link"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "session",
      "description": "Create recurring automated content session",
      "url": "https://www.citedy.com/api/agent/session",
      "method": "POST",
      "parameters": {
        "type": "object",
        "properties": {
          "categories": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "languages": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "interval_minutes": {
            "type": "integer"
          },
          "article_size": {
            "type": "string"
          }
        },
        "required": [
          "categories",
          "languages",
          "interval_minutes",
          "article_size"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "schedule",
      "description": "View content timeline",
      "url": "https://www.citedy.com/api/agent/schedule",
      "method": "GET",
      "parameters": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      }
    },
    {
      "name": "schedule_gaps",
      "description": "Find schedule gaps (days with fewer posts than target)",
      "url": "https://www.citedy.com/api/agent/schedule/gaps",
      "method": "GET",
      "parameters": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      }
    },
    {
      "name": "schedule_suggest",
      "description": "Get optimal time slot recommendations",
      "url": "https://www.citedy.com/api/agent/schedule/suggest",
      "method": "GET",
      "parameters": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      }
    },
    {
      "name": "scout_x",
      "description": "Scout trends on X/Twitter (async, poll with scout_x_status)",
      "url": "https://www.citedy.com/api/agent/scout/x",
      "method": "POST",
      "parameters": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string"
          },
          "mode": {
            "type": "string"
          },
          "limit": {
            "type": "integer"
          }
        },
        "required": [
          "query",
          "mode",
          "limit"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "scout_x_status",
      "description": "Poll X scout run status",
      "url": "https://www.citedy.com/api/agent/scout/x/{runId}",
      "method": "GET",
      "parameters": {
        "type": "object",
        "properties": {
          "runId": {
            "type": "string",
            "description": "Path parameter: runId"
          }
        },
        "required": [
          "runId"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "scout_reddit",
      "description": "Scout trends on Reddit (async, poll with scout_reddit_status)",
      "url": "https://www.citedy.com/api/agent/scout/reddit",
      "method": "POST",
      "parameters": {
        "type": "object",
        "properties": {
          "subreddits": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "query": {
            "type": "string"
          },
          "limit": {
            "type": "integer"
          }
        },
        "required": [
          "subreddits",
          "query",
          "limit"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "scout_reddit_status",
      "description": "Poll Reddit scout run status",
      "url": "https://www.citedy.com/api/agent/scout/reddit/{runId}",
      "method": "GET",
      "parameters": {
        "type": "object",
        "properties": {
          "runId": {
            "type": "string",
            "description": "Path parameter: runId"
          }
        },
        "required": [
          "runId"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "gaps_get",
      "description": "Get existing content gaps. Optional ?favorite_id=<uuid> scopes to a product/identity (owner-checked, hybrid filter); ?limit=1-100 (default 100).",
      "url": "https://www.citedy.com/api/agent/gaps",
      "method": "GET",
      "parameters": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      }
    },
    {
      "name": "gaps_generate",
      "description": "Generate competitor content gaps. Optional favorite_id (uuid) scopes the run to a product/identity — owner-checked before charge (403 cross-tenant), persisted on each gap, overrides analysis domain to ai_favorites.domain.",
      "url": "https://www.citedy.com/api/agent/gaps/generate",
      "method": "POST",
      "parameters": {
        "type": "object",
        "properties": {
          "competitor_urls": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "favorite_id": {
            "type": "string"
          }
        },
        "required": [
          "competitor_urls",
          "favorite_id"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "competitors_discover",
      "description": "Discover competitors by keywords",
      "url": "https://www.citedy.com/api/agent/competitors/discover",
      "method": "POST",
      "parameters": {
        "type": "object",
        "properties": {
          "keywords": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "keywords"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "competitors_scout",
      "description": "Deep-analyze a competitor domain",
      "url": "https://www.citedy.com/api/agent/competitors/scout",
      "method": "POST",
      "parameters": {
        "type": "object",
        "properties": {
          "domain": {
            "type": "string"
          },
          "mode": {
            "type": "string"
          }
        },
        "required": [
          "domain",
          "mode"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "products_upload",
      "description": "Upload product document for context-aware content",
      "url": "https://www.citedy.com/api/agent/products",
      "method": "POST",
      "parameters": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string"
          },
          "content": {
            "type": "string"
          },
          "source_type": {
            "type": "string"
          }
        },
        "required": [
          "title",
          "content",
          "source_type"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "products_list",
      "description": "List product knowledge documents",
      "url": "https://www.citedy.com/api/agent/products",
      "method": "GET",
      "parameters": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      }
    },
    {
      "name": "products_delete",
      "description": "Delete product document",
      "url": "https://www.citedy.com/api/agent/products/{id}",
      "method": "DELETE",
      "parameters": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Path parameter: id"
          }
        },
        "required": [
          "id"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "products_search",
      "description": "Vector similarity search over product knowledge",
      "url": "https://www.citedy.com/api/agent/products/search",
      "method": "POST",
      "parameters": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string"
          },
          "limit": {
            "type": "integer"
          }
        },
        "required": [
          "query",
          "limit"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "ingest",
      "description": "Ingest URL (YouTube, article, PDF, audio) into structured content",
      "url": "https://www.citedy.com/api/agent/ingest",
      "method": "POST",
      "parameters": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string"
          }
        },
        "required": [
          "url"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "ingest_list",
      "description": "List ingestion jobs",
      "url": "https://www.citedy.com/api/agent/ingest",
      "method": "GET",
      "parameters": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      }
    },
    {
      "name": "ingest_status",
      "description": "Poll ingestion job status",
      "url": "https://www.citedy.com/api/agent/ingest/{id}",
      "method": "GET",
      "parameters": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Path parameter: id"
          }
        },
        "required": [
          "id"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "ingest_content",
      "description": "Get full extracted text from ingestion",
      "url": "https://www.citedy.com/api/agent/ingest/{id}/content",
      "method": "GET",
      "parameters": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Path parameter: id"
          }
        },
        "required": [
          "id"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "ingest_batch",
      "description": "Batch ingest up to 20 URLs",
      "url": "https://www.citedy.com/api/agent/ingest/batch",
      "method": "POST",
      "parameters": {
        "type": "object",
        "properties": {
          "urls": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "callback_url": {
            "type": "string"
          }
        },
        "required": [
          "urls",
          "callback_url"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "lead_magnets_create",
      "description": "Generate PDF lead magnet (checklist, swipe file, framework)",
      "url": "https://www.citedy.com/api/agent/lead-magnets",
      "method": "POST",
      "parameters": {
        "type": "object",
        "properties": {
          "topic": {
            "type": "string"
          },
          "type": {
            "type": "string"
          },
          "language": {
            "type": "string"
          },
          "generate_images": {
            "type": "boolean"
          }
        },
        "required": [
          "topic",
          "type",
          "language",
          "generate_images"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "lead_magnets_status",
      "description": "Poll lead magnet generation status",
      "url": "https://www.citedy.com/api/agent/lead-magnets/{id}",
      "method": "GET",
      "parameters": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Path parameter: id"
          }
        },
        "required": [
          "id"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "lead_magnets_publish",
      "description": "Publish lead magnet (generates public_url)",
      "url": "https://www.citedy.com/api/agent/lead-magnets/{id}",
      "method": "PATCH",
      "parameters": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Path parameter: id"
          },
          "status": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "status"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "lead_magnets_archive",
      "description": "Archive a lead magnet",
      "url": "https://www.citedy.com/api/agent/lead-magnets/{id}",
      "method": "PATCH",
      "parameters": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Path parameter: id"
          },
          "status": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "status"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "lead_magnets_wait",
      "description": "Long-poll lead magnet generation (blocks until complete or timeout)",
      "url": "https://www.citedy.com/api/agent/lead-magnets/{id}/wait",
      "method": "GET",
      "parameters": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Path parameter: id"
          }
        },
        "required": [
          "id"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "pending_status",
      "description": "Universal async job poller (works for any pending operation)",
      "url": "https://www.citedy.com/api/agent/pending/{id}",
      "method": "GET",
      "parameters": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Path parameter: id"
          }
        },
        "required": [
          "id"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "shorts_script",
      "description": "Generate speech script for short-form video",
      "url": "https://www.citedy.com/api/agent/shorts/script",
      "method": "POST",
      "parameters": {
        "type": "object",
        "properties": {
          "topic": {
            "type": "string"
          },
          "duration": {
            "type": "string"
          },
          "style": {
            "type": "string"
          },
          "language": {
            "type": "string"
          }
        },
        "required": [
          "topic",
          "duration",
          "style",
          "language"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "shorts_avatar",
      "description": "Generate AI avatar image for video",
      "url": "https://www.citedy.com/api/agent/shorts/avatar",
      "method": "POST",
      "parameters": {
        "type": "object",
        "properties": {
          "gender": {
            "type": "string"
          },
          "origin": {
            "type": "string"
          },
          "age_range": {
            "type": "string"
          },
          "type": {
            "type": "string"
          },
          "location": {
            "type": "string"
          }
        },
        "required": [
          "gender",
          "origin",
          "age_range",
          "type",
          "location"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "shorts_video",
      "description": "Generate AI UGC viral video segment (async)",
      "url": "https://www.citedy.com/api/agent/shorts",
      "method": "POST",
      "parameters": {
        "type": "object",
        "properties": {
          "prompt": {
            "type": "string"
          },
          "avatar_url": {
            "type": "string"
          },
          "duration": {
            "type": "integer"
          },
          "speech_text": {
            "type": "string"
          }
        },
        "required": [
          "prompt",
          "avatar_url",
          "duration",
          "speech_text"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "shorts_status",
      "description": "Poll video generation status",
      "url": "https://www.citedy.com/api/agent/shorts/{id}",
      "method": "GET",
      "parameters": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Path parameter: id"
          }
        },
        "required": [
          "id"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "shorts_merge",
      "description": "Merge video segments with subtitles",
      "url": "https://www.citedy.com/api/agent/shorts/merge",
      "method": "POST",
      "parameters": {
        "type": "object",
        "properties": {
          "video_urls": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "phrases": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "text": {
                  "type": "string"
                }
              },
              "required": [
                "text"
              ],
              "additionalProperties": false
            }
          }
        },
        "required": [
          "video_urls",
          "phrases"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "shorts_publish",
      "description": "Publish video directly to YouTube Shorts, Instagram Reels, and/or TikTok. tiktok_privacy_level is strongly recommended (effectively required) when targets includes TikTok; the only fallback is privacy_status=\"private\" which maps to SELF_ONLY.",
      "url": "https://www.citedy.com/api/agent/shorts/publish",
      "method": "POST",
      "parameters": {
        "type": "object",
        "properties": {
          "video_url": {
            "type": "string"
          },
          "speech_text": {
            "type": "string"
          },
          "targets": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "platform": {
                  "type": "string"
                },
                "account_id": {
                  "type": "string"
                }
              },
              "required": [
                "platform",
                "account_id"
              ],
              "additionalProperties": false
            }
          },
          "privacy_status": {
            "type": "string"
          },
          "tiktok_privacy_level": {
            "type": "string"
          }
        },
        "required": [
          "video_url",
          "speech_text",
          "targets",
          "privacy_status",
          "tiktok_privacy_level"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "seo_meta_tags",
      "description": "Check meta tags (title, description, OG) for any URL",
      "url": "https://www.citedy.com/api/agent/tools/meta-tags",
      "method": "POST",
      "parameters": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string"
          }
        },
        "required": [
          "url"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "seo_headings",
      "description": "Analyze heading structure (H1-H6) for any URL",
      "url": "https://www.citedy.com/api/agent/tools/headings",
      "method": "POST",
      "parameters": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string"
          }
        },
        "required": [
          "url"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "seo_links",
      "description": "Analyze internal and external links on a page",
      "url": "https://www.citedy.com/api/agent/tools/links",
      "method": "POST",
      "parameters": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string"
          }
        },
        "required": [
          "url"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "seo_internal_links",
      "description": "Plan internal linking strategy between pages",
      "url": "https://www.citedy.com/api/agent/tools/internal-links",
      "method": "POST",
      "parameters": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string"
          },
          "targetUrls": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "url",
          "targetUrls"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "seo_og_preview",
      "description": "Preview Open Graph social card for any URL",
      "url": "https://www.citedy.com/api/agent/tools/og-preview",
      "method": "POST",
      "parameters": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string"
          }
        },
        "required": [
          "url"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "seo_schema_validate",
      "description": "Validate Schema.org structured data on a page",
      "url": "https://www.citedy.com/api/agent/tools/schema-validate",
      "method": "POST",
      "parameters": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string"
          }
        },
        "required": [
          "url"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "seo_robots",
      "description": "Check robots.txt rules for a domain",
      "url": "https://www.citedy.com/api/agent/tools/robots",
      "method": "POST",
      "parameters": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string"
          }
        },
        "required": [
          "url"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "seo_sitemap",
      "description": "Check sitemap.xml validity and coverage",
      "url": "https://www.citedy.com/api/agent/tools/sitemap",
      "method": "POST",
      "parameters": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string"
          }
        },
        "required": [
          "url"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "seo_og_image",
      "description": "Generate custom OG image for social sharing",
      "url": "https://www.citedy.com/api/agent/tools/og-image",
      "method": "POST",
      "parameters": {
        "type": "object",
        "properties": {
          "brandName": {
            "type": "string"
          },
          "logoUrl": {
            "type": "string"
          },
          "template": {
            "type": "string"
          }
        },
        "required": [
          "brandName",
          "logoUrl",
          "template"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "brand_scan",
      "description": "Scan brand visibility across AI platforms (async, poll with brand_scan_status)",
      "url": "https://www.citedy.com/api/agent/tools/brand-scan",
      "method": "POST",
      "parameters": {
        "type": "object",
        "properties": {
          "brandName": {
            "type": "string"
          }
        },
        "required": [
          "brandName"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "brand_scan_status",
      "description": "Poll brand scan status",
      "url": "https://www.citedy.com/api/agent/tools/brand-scan/{id}",
      "method": "GET",
      "parameters": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Path parameter: id"
          }
        },
        "required": [
          "id"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "gsc_report",
      "description": "Google Search Console performance report — clicks, impressions, CTR, positions, top queries, movers, opportunities, article suggestions. Returns connect URL if GSC not linked.",
      "url": "https://www.citedy.com/api/agent/gsc/report",
      "method": "GET",
      "parameters": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      }
    },
    {
      "name": "webhooks_create",
      "description": "Register webhook endpoint (max 10 per agent)",
      "url": "https://www.citedy.com/api/agent/webhooks",
      "method": "POST",
      "parameters": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string"
          },
          "event_types": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "description": {
            "type": "string"
          }
        },
        "required": [
          "url",
          "event_types",
          "description"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "webhooks_list",
      "description": "List webhook endpoints",
      "url": "https://www.citedy.com/api/agent/webhooks",
      "method": "GET",
      "parameters": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      }
    },
    {
      "name": "webhooks_delete",
      "description": "Delete webhook endpoint",
      "url": "https://www.citedy.com/api/agent/webhooks/{id}",
      "method": "DELETE",
      "parameters": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Path parameter: id"
          }
        },
        "required": [
          "id"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "webhooks_deliveries",
      "description": "View webhook delivery history",
      "url": "https://www.citedy.com/api/agent/webhooks/deliveries",
      "method": "GET",
      "parameters": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      }
    }
  ]
}