web-search

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'description': 'The URL to fetch. Example: "https://example.com"'}, 'live': {'type': 'boolean', 'default': False, 'description': 'Fetch live content. Defaults to false.'}, 'prompt': {'type': 'string', 'maxLength': 2000, 'description': 'Optional extraction instruction. When set, an LLM reads the fetched page and the returned content is only the output for this instruction instead of the full page. Example: "List all pricing tiers with their monthly prices".'}, 'max_chars': {'type': 'integer', 'minimum': 1, 'description': 'Maximum number of characters of content to return. Longer content is truncated. Defaults to 50000 when omitted.'}, 'session_id': {'type': 'string', 'maxLength': 128, 'description': 'Optional id of the agent session making this call. Send the same value on every call in one session so its requests can be grouped.'}, 'output_format': {'enum': ['text', 'json'], 'type': 'string', 'default': 'text', 'description': "Response format: 'text' (default) for readable text, or 'json' for the raw response serialized as JSON."}}}

{'type': 'object', 'required': ['query'], 'properties': {'mode': {'enum': ['realtime', 'pro'], 'type': 'string', 'description': "Search mode: 'pro' (default) for enhanced results or 'realtime' for fastest results"}, 'site': {'type': 'string', 'description': 'Restrict results to a specific site (e.g. "techcrunch.com")'}, 'query': {'type': 'string', 'description': 'Natural language search query. Should be a semantically rich description of the ideal page, not just keywords.'}, 'query_time': {'type': 'string', 'description': 'Point-in-time search: exclude pages newer than this timestamp. Accepts an ISO 8601 datetime (e.g. "2026-09-20T00:00:00Z"), a YYYY-MM-DD date, a Unix epoch, or a relative offset back from now (e.g. "7d", "2w", "30min")'}, 'session_id': {'type': 'string', 'maxLength': 128, 'description': 'Optional id of the agent session making this call. Send the same value on every call in one session so its requests can be grouped.'}, 'max_results': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Maximum number of results to return. When omitted, a default count (10) is used.'}, 'enableWizards': {'type': 'boolean', 'default': False, 'description': "Experimental: use wizards (structured data outputs). Only valid in 'pro' mode."}, 'output_format': {'enum': ['text', 'json'], 'type': 'string', 'default': 'text', 'description': "Response format: 'text' (default) for readable text, or 'json' for the raw response serialized as JSON."}, 'acquired_after': {'type': 'string', 'description': 'Filter results to pages acquired/indexed after this date (YYYY-MM-DD)'}, 'acquired_before': {'type': 'string', 'description': 'Filter results to pages acquired/indexed before this date (YYYY-MM-DD)'}, 'published_after': {'type': 'string', 'description': 'Filter results to pages published after this date (YYYY-MM-DD)'}, 'published_before': {'type': 'string', 'description': 'Filter results to pages published before this date (YYYY-MM-DD)'}, 'snippet_max_length': {'type': 'integer', 'maximum': 10000, 'minimum': 180, 'description': 'Maximum length (characters) of the snippet returned per result. When omitted, a default length is used.'}}}