{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query with operators (e.g. 'from:elonmusk AI min_faves:100 within_time:7d')"
    },
    "sort": {
      "description": "Sort by relevance or recency: \"top\" (most engaged tweets matching the query - best for \"what's the conversation about X\") or \"latest\" (newest first - best for monitoring/recency). Default: \"top\".",
      "type": "string",
      "enum": [
        "latest",
        "top"
      ]
    },
    "cursor": {
      "description": "Pagination cursor from previous search",
      "type": "string"
    },
    "start_date": {
      "description": "Only tweets on or after this time. YYYY-MM-DD (UTC midnight) or ISO 8601 datetime with Z/offset (e.g. 2026-04-13T14:30:00Z)",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:?\\d{2}))?$"
    },
    "end_date": {
      "description": "Only tweets before this time. YYYY-MM-DD (inclusive through end of day UTC) or ISO 8601 datetime with Z/offset (e.g. 2026-04-13T14:30:00Z)",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:?\\d{2}))?$"
    },
    "format": {
      "default": "text",
      "description": "Output format. 'text' (default): compact human-readable view, fewer tokens. 'json': full structured data for machine parsing.",
      "type": "string",
      "enum": [
        "text",
        "json"
      ]
    },
    "expand_urls": {
      "default": false,
      "description": "When true, auto-crawl entity URLs and attach crawled_content to tweets. Off by default: responses can grow by up to 4KB per expanded URL. Use glim_web_fetch(url) for targeted crawls instead.",
      "type": "boolean"
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "ref": {
      "type": "string",
      "description": "Tweet URL or profile URL. A tweet URL (incl. /i/status/<id>) returns the tweet + thread; a profile URL (https://x.com/<handle>) returns the user + recent tweets. Prefer full URLs - if you only have a numeric id, pass it as a quoted string."
    },
    "include": {
      "description": "Tweet refs only: also fetch 'replies' and/or 'quotes'",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "replies",
          "quotes"
        ]
      }
    },
    "include_replies": {
      "default": false,
      "description": "Profile refs only: include replies in the timeline",
      "type": "boolean"
    },
    "include_mentions": {
      "default": false,
      "description": "Profile refs only: include the mentions timeline",
      "type": "boolean"
    },
    "cursor": {
      "description": "Profile refs only: pagination cursor from next_cursor",
      "type": "string"
    },
    "format": {
      "default": "text",
      "description": "Output format. 'text' (default): compact human-readable view, fewer tokens. 'json': full structured data for machine parsing.",
      "type": "string",
      "enum": [
        "text",
        "json"
      ]
    },
    "expand_urls": {
      "default": false,
      "description": "When true, auto-crawl entity URLs and attach crawled_content to tweets. Off by default: responses can grow by up to 4KB per expanded URL. Use glim_web_fetch(url) for targeted crawls instead.",
      "type": "boolean"
    }
  },
  "required": [
    "ref"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query (e.g. 'subreddit:programming machine learning')"
    },
    "sort": {
      "default": "relevance",
      "description": "Sort order. Keep 'relevance' (default) for question or topic queries - it ranks by how well posts match your query. 'top'/'hot' rank by score/recency and largely ignore the query text, so use them only to browse what's popular in a subreddit.",
      "type": "string",
      "enum": [
        "relevance",
        "hot",
        "top",
        "new",
        "comments"
      ]
    },
    "time": {
      "default": "all",
      "description": "Time range",
      "type": "string",
      "enum": [
        "hour",
        "day",
        "week",
        "month",
        "year",
        "all"
      ]
    },
    "limit": {
      "default": 10,
      "description": "Max posts (1-10), each with full content + top comments",
      "type": "integer",
      "minimum": 1,
      "maximum": 10
    },
    "cursor": {
      "description": "Pagination cursor from a prior response's next_cursor",
      "type": "string"
    },
    "start_date": {
      "description": "Only posts on or after this date (YYYY-MM-DD)",
      "type": "string"
    },
    "end_date": {
      "description": "Only posts before this date (YYYY-MM-DD)",
      "type": "string"
    },
    "format": {
      "default": "text",
      "description": "Output format. 'text' (default): compact human-readable view, fewer tokens. 'json': full structured data for machine parsing.",
      "type": "string",
      "enum": [
        "text",
        "json"
      ]
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "ref": {
      "type": "string",
      "description": "Post ID or URL, subreddit ref (r/programming or reddit.com/r/programming), or user ref (u/spez or reddit.com/user/spez)"
    },
    "comment_sort": {
      "default": "confidence",
      "description": "Comment sort",
      "type": "string",
      "enum": [
        "confidence",
        "top",
        "new",
        "controversial",
        "old",
        "qa"
      ]
    },
    "comment_limit": {
      "default": 50,
      "description": "Max comments",
      "type": "integer",
      "minimum": 0,
      "maximum": 200
    },
    "comment_depth": {
      "default": 5,
      "description": "Max nesting depth",
      "type": "integer",
      "minimum": 0,
      "maximum": 10
    },
    "sort": {
      "default": "hot",
      "description": "Listing post sort",
      "type": "string",
      "enum": [
        "hot",
        "new",
        "top",
        "rising"
      ]
    },
    "time": {
      "default": "day",
      "description": "Listing time range",
      "type": "string",
      "enum": [
        "hour",
        "day",
        "week",
        "month",
        "year",
        "all"
      ]
    },
    "limit": {
      "default": 10,
      "description": "Max subreddit posts (1-10), each with full content + top comments",
      "type": "integer",
      "minimum": 1,
      "maximum": 10
    },
    "cursor": {
      "description": "Pagination cursor from a prior subreddit response's next_cursor",
      "type": "string"
    },
    "include_posts": {
      "default": true,
      "description": "Include recent posts for user refs",
      "type": "boolean"
    },
    "include_comments": {
      "default": false,
      "description": "Include recent comments for user refs",
      "type": "boolean"
    },
    "format": {
      "default": "text",
      "description": "Output format. 'text' (default): compact human-readable view, fewer tokens. 'json': full structured data for machine parsing.",
      "type": "string",
      "enum": [
        "text",
        "json"
      ]
    }
  },
  "required": [
    "ref"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "include_domains": {
      "description": "Restrict results to these domains (e.g. ['arxiv.org'])",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "exclude_domains": {
      "description": "Exclude results from these domains. Useful for filtering noisy aggregators or SEO farms when you've seen them dominate results (e.g. ['pinterest.com', 'quora.com']).",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "published_within_days": {
      "description": "Restrict to results published within the last N days. Skip this for broad queries - it excludes pages without publish-date metadata. Common values: 1, 7, 30, 365.",
      "type": "integer",
      "minimum": 1,
      "maximum": 3650
    },
    "format": {
      "default": "text",
      "description": "Output format. 'text' (default): compact human-readable list, fewer tokens. 'json': full structured data incl. the highlights array per result.",
      "type": "string",
      "enum": [
        "text",
        "json"
      ]
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "URL to fetch"
    },
    "format": {
      "default": "markdown",
      "description": "Output format. 'markdown' (default) clean article text; 'html' raw cleaned HTML; 'json' the structured SSR blob (TikTok / Pinterest / YouTube) instead of article text.",
      "type": "string",
      "enum": [
        "markdown",
        "html",
        "json"
      ]
    },
    "selector": {
      "description": "CSS selector to scope extraction",
      "type": "string"
    }
  },
  "required": [
    "url"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query in full GitHub search syntax: qualifiers (repo:owner/name, org:/user:, language:, path: with globs, symbol:, content:, is:, stars:>N, label:, sort:stars), boolean AND/OR/NOT with parentheses, \"exact strings\", and /regex/. kind=repos: minimal distinctive keywords - the project/library name (GOOD: 'rtk', 'react query'; BAD: 'rtk rust token killer' - every extra word must ALL match and buries the real repo; filter with qualifiers, not prose). kind=code: ONE literal code pattern as it appears in files ('useState('), an \"exact string\", a /regex/, or symbol:name for definitions; narrow with repo:/language:/path:, not extra words. kind=conversations: keywords plus filters (is:issue, label:bug). Caution: sort: REPLACES relevance ranking (sort:reactions = most-popular thread mentioning the words anywhere, incl. comments) - omit sort: for best-match. Not supported in code search: license:, enterprise:, is:vendored, is:generated."
    },
    "kind": {
      "description": "What to search: 'repos', 'conversations' (issues+PRs), or 'code' (literal/regex/symbol search across 2.8M+ public GitHub repos). Optional - inferred from the query: is:/label:/author: implies conversations, path:/symbol:/content://regex/ implies code, stars:/topic:/in:readme implies repos, otherwise repos. type:code / type:repos in the query also works.",
      "type": "string",
      "enum": [
        "repos",
        "conversations",
        "code"
      ]
    },
    "repo": {
      "description": "Scope to one repository. Accepts 'owner/name', a github.com URL, or a partial 'owner/' (code). Works with any kind; setting it with kind=repos routes the search to conversations, since repo-name search can't scope to one repo. Equivalent to a repo: qualifier in the query (if both are given they must match).",
      "type": "string"
    },
    "page": {
      "description": "Page number",
      "default": 1,
      "type": "integer",
      "minimum": 1,
      "maximum": 10
    },
    "per_page": {
      "description": "Results per page",
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 30
    },
    "format": {
      "default": "text",
      "description": "Output format. 'text' (default): compact human-readable previews, fewer tokens. 'json': full structured data for machine parsing.",
      "type": "string",
      "enum": [
        "text",
        "json"
      ]
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "ref": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2048,
      "description": "GitHub URL or 'owner/repo' shorthand. A repo URL or owner/repo returns metadata + README; /pull/N -> PR (with comments + changed files), /issues/N -> issue, /blob/<ref>/<path> -> file (raw.githubusercontent.com URLs work too), /tree/<ref>[/<path>] -> file tree (optionally scoped to a subdirectory), /commit/<sha> -> one commit with diff, /commits[/<ref>/<path>] -> history (optionally for one file), /branches, /releases (or /releases/tag/<tag> | /releases/latest -> one release), /topics/<name> -> top repos with that topic (by stars)."
    },
    "page": {
      "description": "Page number",
      "default": 1,
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "per_page": {
      "description": "Results per page",
      "default": 30,
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "format": {
      "default": "text",
      "description": "Output encoding. 'text' (default): compact human-readable text, fewer tokens (file returns raw content). 'json': machine-readable JSON.",
      "type": "string",
      "enum": [
        "text",
        "json"
      ]
    }
  },
  "required": [
    "ref"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Free-text keyword query (mutually exclusive with category_slug)",
      "type": "string"
    },
    "category_slug": {
      "description": "Amazon bestsellers category slug, e.g. 'electronics' (.com), 'elektronik' (.de), 'electronique' (.fr). Invalid slugs return 'not_found' - retry with a correct slug.",
      "type": "string"
    },
    "tld": {
      "default": "com",
      "type": "string",
      "enum": [
        "com",
        "co.uk",
        "de",
        "fr",
        "es",
        "it"
      ],
      "description": "Amazon marketplace: com | co.uk | de | fr | es | it"
    },
    "page": {
      "default": 1,
      "description": "Page number (1-20)",
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    },
    "format": {
      "default": "text",
      "description": "Output format. 'text' (default): compact human-readable view, fewer tokens. 'json': full structured data (offers[], images, variants).",
      "type": "string",
      "enum": [
        "text",
        "json"
      ]
    },
    "sort_by": {
      "description": "Server-side sort, except 'most_reviewed' which re-ranks the current page client-side by review count desc (rating tiebreaker). Pair 'most_reviewed' with min_reviews to skip thinly-reviewed items.",
      "type": "string",
      "enum": [
        "most_recent",
        "price_low_to_high",
        "price_high_to_low",
        "featured",
        "average_review",
        "bestsellers",
        "most_reviewed"
      ]
    },
    "min_reviews": {
      "description": "Drop hits with fewer than N reviews. Pair with sort_by='most_reviewed' for a trust-weighted result. Applied client-side to organic/paid/suggested.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "include_paid": {
      "default": false,
      "description": "Include sponsored ad results (default: dropped)",
      "type": "boolean"
    },
    "include_suggested": {
      "default": false,
      "description": "Include 'people also searched for' suggestions (default: dropped)",
      "type": "boolean"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "ref": {
      "type": "string",
      "minLength": 1,
      "description": "Full Amazon product URL - pass the `url` from a glim_amazon_search result, or any /dp/<ASIN> product page URL. The URL carries the marketplace (amazon.de, amazon.co.uk, ...), so no separate region is needed; tracking junk in the URL is ignored. A bare ASIN is rejected: it is ambiguous across marketplaces."
    },
    "format": {
      "default": "text",
      "description": "Output format. 'text' (default): compact human-readable view, fewer tokens. 'json': full structured data (offers[], images, variants).",
      "type": "string",
      "enum": [
        "text",
        "json"
      ]
    }
  },
  "required": [
    "ref"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "ref": {
      "type": "string",
      "minLength": 1,
      "description": "YouTube video URL or 11-char video id (e.g. https://youtu.be/dQw4w9WgXcQ, https://www.youtube.com/watch?v=dQw4w9WgXcQ, or dQw4w9WgXcQ)"
    },
    "language_code": {
      "default": "en",
      "description": "ISO 639-1 language code (e.g. 'en', 'de', 'fr')",
      "type": "string",
      "minLength": 2,
      "maxLength": 10
    },
    "origin": {
      "default": "uploader_provided",
      "description": "'uploader_provided' for human captions (default), 'auto_generated' for YouTube auto-captions.",
      "type": "string",
      "enum": [
        "uploader_provided",
        "auto_generated"
      ]
    },
    "format": {
      "description": "Output format. 'text' (default): the cleaned transcript inline as plain text (omitted with a download_url note when it exceeds the ~40K-char inline cap). 'json': the same cleaned transcript plus structured metadata and a presigned download_url - for batch/programmatic use. Both formats return the identical cleaned, deduplicated transcript.",
      "default": "text",
      "type": "string",
      "enum": [
        "text",
        "json"
      ]
    }
  },
  "required": [
    "ref",
    "format"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}