{"id":"speedworkers_page_snapshot","name":"SpeedWorkers Page Snapshot","alias":"SpeedworkersPageSnapshot","aliases":[],"description_short":"Get the HTML SpeedWorkers stored for a URL during a past indexation.","description_long":"\n    Get what Botify SpeedWorkers stored during one past indexation of a page:\n    the HTML received (and rendered) from the origin, the URL fetched, the HTTP\n    status code and headers returned by the origin, the canonical URL, a summary\n    of the JavaScript rendering, and the indexation job (cache behavior,\n    rendering config, inventory sources and page properties).\n\n    The indexation event is identified by the `event_id` returned by\n    `speedworkers_page_history`. Old events may no longer be available. Use\n    `speedworkers_page_preview` for the page currently delivered to bots.\n\n    Header values that may hold credentials (cookies, authorization...) and\n    credentials in URLs are masked. With `save_to_tmp_storage`, the HTML is saved\n    to temporary storage and its URL is returned instead.\n\n    The project must have SpeedWorkers enabled.\n    ","description_tool_prompt":"\n    Get what Botify SpeedWorkers stored during one past indexation of a page:\n    the HTML received (and rendered) from the origin, the URL fetched, the HTTP\n    status code and headers returned by the origin, the canonical URL, a summary\n    of the JavaScript rendering, and the indexation job (cache behavior,\n    rendering config, inventory sources and page properties).\n\n    The indexation event is identified by the `event_id` returned by\n    `speedworkers_page_history`. Old events may no longer be available. Use\n    `speedworkers_page_preview` for the page currently delivered to bots.\n\n    Header values that may hold credentials (cookies, authorization...) and\n    credentials in URLs are masked. With `save_to_tmp_storage`, the HTML is saved\n    to temporary storage and its URL is returned instead.\n\n    The project must have SpeedWorkers enabled.\n    ","source":"Botify SpeedWorkers","conversation_examples":[],"tags":["url data"],"available_in_chat":true,"available_in_deepthink":true,"available_in_mcp":true,"mcp_audience":"all","config":{"type":"object","properties":{"save_to_tmp_storage":{"default":false,"description":"Save the HTML to Botify temporary storage and return the temporary URL instead of the HTML. Use this to save output tokens. The returned URL can be passed to other HTML-processing tools. Headers and details are still returned.","title":"Save To Temporary Storage","type":"boolean"}},"required":[]},"item":{"type":"object","properties":{"event_id":{"description":"The `event_id` of an indexation event, as returned by the `speedworkers_page_history` tool.","title":"Event ID","type":"string"}},"required":["event_id"]},"response":{"$defs":{"SpeedWorkersCanonical":{"properties":{"has_canonical":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Whether the page declares a canonical URL","title":"Has Canonical"},"canonical_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Canonical URL declared by the page","title":"Canonical Url"},"canonical_equal":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Whether the canonical URL is the page URL","title":"Canonical Equal"}},"title":"SpeedWorkersCanonical","type":"object"},"SpeedWorkersIndexationJob":{"properties":{"section_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ID of the matching cache behavior (section)","title":"Section Id"},"config_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ID of the rendering config used","title":"Config Id"},"config_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Type of the rendering config (device)","title":"Config Type"},"input_ids":{"default":[],"description":"IDs of the inventory sources of the page","items":{"type":"string"},"title":"Input Ids","type":"array"},"page_properties":{"default":[],"description":"Page properties at the time of the indexation","items":{"$ref":"#/$defs/SpeedWorkersPageProperty"},"title":"Page Properties","type":"array"},"status_code":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Status code of the page known before the job","title":"Status Code"},"previous_status_code":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Previous status code of the page","title":"Previous Status Code"},"batch_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Date of the indexation batch","title":"Batch Date"}},"title":"SpeedWorkersIndexationJob","type":"object"},"SpeedWorkersJsRendering":{"properties":{"device":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Rendering device","title":"Device"},"rendered":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Whether the page was rendered with JavaScript","title":"Rendered"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Rendering status","title":"Status"},"redirect_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Redirect target found during the rendering","title":"Redirect Url"},"version_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Version of the rendering engine","title":"Version Code"},"rendering_time_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Rendering time, in ms","title":"Rendering Time Ms"},"nb_resources":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Number of resources requested by the page","title":"Nb Resources"},"nb_resources_error":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Number of resources that failed to load","title":"Nb Resources Error"}},"title":"SpeedWorkersJsRendering","type":"object"},"SpeedWorkersPageProperty":{"properties":{"input":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ID of the inventory source of the property","title":"Input"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Property name","title":"Name"},"value":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Property value","title":"Value"}},"title":"SpeedWorkersPageProperty","type":"object"}},"properties":{"html":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"HTML of the page as stored by SpeedWorkers during this indexation. Omitted when `save_to_tmp_storage` is True; see `html_tmp_storage_url` instead.","title":"Html"},"html_tmp_storage_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Temporary storage URL of the HTML page. Returned instead of `html` when `save_to_tmp_storage` is True. Can be passed to other HTML-processing tools.","title":"Html Tmp Storage Url"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"URL fetched by SpeedWorkers from the origin","title":"Url"},"indexed_at":{"description":"When the indexation happened","format":"date-time","title":"Indexed At","type":"string"},"status_code":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"HTTP status code returned by the origin","title":"Status Code"},"headers":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"default":null,"description":"HTTP headers returned by the origin; values that may hold credentials (cookies, authorization...) are masked with `**`","title":"Headers"},"canonical":{"anyOf":[{"$ref":"#/$defs/SpeedWorkersCanonical"},{"type":"null"}],"default":null,"description":"Canonical URL found in the page"},"js_rendering":{"anyOf":[{"$ref":"#/$defs/SpeedWorkersJsRendering"},{"type":"null"}],"default":null,"description":"Summary of the JavaScript rendering"},"job":{"anyOf":[{"$ref":"#/$defs/SpeedWorkersIndexationJob"},{"type":"null"}],"default":null,"description":"Indexation job: cache behavior, rendering config, inventory sources and page properties"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Why no HTML was returned, if any","title":"Reason"}},"required":["indexed_at"],"title":"SpeedWorkersPageSnapshotProcessedItem","type":"object"},"has_canvas":false,"open_canvas_automatically":false}