{
"type": "object",
"properties": {
"urls": {
"type": "array",
"items": {
"type": "string"
},
"description": "Array of URLs to scrape (required). Can be full URLs or just domain names like \"google.com\""
},
"formats": {
"type": "array",
"items": {
"type": "string",
"enum": [
"markdown",
"html",
"rawHtml",
"links",
"summary"
]
},
"default": [
"markdown"
],
"description": "Output formats: \"markdown\" (default), \"html\", \"rawHtml\", \"links\", \"summary\""
},
"onlyMainContent": {
"type": "boolean",
"default": true,
"description": "Extract only main content, excluding headers/footers/nav (default: true)"
},
"removeBase64Images": {
"type": "boolean",
"default": true,
"description": "Remove base64 encoded images from output (default: true)"
},
"waitFor": {
"type": "number",
"description": "Milliseconds to wait before scraping. Use for pages with dynamic content that loads after initial render. Example: 2000 for 2 seconds"
},
"actions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"wait",
"click",
"scroll",
"screenshot",
"write",
"press"
],
"description": "Action type to perform"
},
"milliseconds": {
"type": "number",
"description": "For \"wait\" action: milliseconds to wait"
},
"selector": {
"type": "string",
"description": "CSS selector for click/scroll/write. Examples: \"button.submit\", \"#search-input\", \"[data-testid=login]\""
},
"direction": {
"type": "string",
"enum": [
"up",
"down"
],
"description": "For \"scroll\" action: direction to scroll"
},
"fullPage": {
"type": "boolean",
"description": "For \"screenshot\" action: true to capture entire page"
},
"text": {
"type": "string",
"description": "For \"write\" action: text to type into the selected element"
},
"key": {
"type": "string",
"description": "For \"press\" action: key to press (e.g., \"Enter\", \"Tab\", \"Escape\")"
}
}
},
"description": "Browser actions to perform before scraping. Actions execute in order. Examples:\n- Wait: {\"type\": \"wait\", \"milliseconds\": 2000}\n- Click button: {\"type\": \"click\", \"selector\": \"button.load-more\"}\n- Scroll down: {\"type\": \"scroll\", \"selector\": \"body\", \"direction\": \"down\"}\n- Type in input: {\"type\": \"write\", \"selector\": \"#search\", \"text\": \"search query\"}\n- Press Enter: {\"type\": \"press\", \"key\": \"Enter\"}\n- Take screenshot: {\"type\": \"screenshot\", \"fullPage\": true}"
},
"includeTags": {
"type": "array",
"items": {
"type": "string"
},
"description": "HTML tags to include (e.g., [\"div\", \"p\", \"h1\"])"
},
"excludeTags": {
"type": "array",
"items": {
"type": "string"
},
"description": "HTML tags to exclude (e.g., [\"script\", \"style\"])"
},
"location": {
"type": "object",
"properties": {
"country": {
"type": "string",
"description": "ISO country code (US, GB, DE)"
},
"languages": {
"type": "array",
"items": {
"type": "string"
},
"description": "Language preferences"
}
},
"description": "Location/language settings for geo-specific content"
}
},
"required": [
"urls"
]
}