live_search
Search the web in real-time to get current answers with source citations. Find up-to-date information from news, social media, and RSS feeds for fact-checking and research.
Instructions
Searches the web in real-time and provides answers with sources.
This is like having Grok browse the internet for you. It searches the web, news,
X (Twitter), and even RSS feeds, then synthesizes everything into a comprehensive
answer. You'll get citations so you can verify the information. Great for current
events, fact-checking, or anything requiring up-to-date information.
Args:
prompt: Your question or search query
model: Which Grok model to use (default is grok-4)
mode: "on" to enable search (default), "off" to disable
return_citations: Whether to include source links (default True)
from_date: Start date for search results (YYYY-MM-DD format)
to_date: End date for search results (YYYY-MM-DD format)
max_search_results: How many sources to check (default 20)
country: Filter results by country code (e.g., "us", "uk")
rss_links: List of RSS feed URLs to include
sources: Custom source configuration (overrides country/rss_links if provided)
system_prompt: Instructions for how to handle the search results
Returns a dict with 'content' (the answer), 'citations' (sources used),
'usage' (tokens), and 'num_sources_used'.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| country | No | ||
| from_date | No | ||
| max_search_results | No | ||
| mode | No | on | |
| model | No | grok-4 | |
| prompt | Yes | ||
| return_citations | No | ||
| rss_links | No | ||
| sources | No | ||
| system_prompt | No | ||
| to_date | No |
Input Schema (JSON Schema)
{
"properties": {
"country": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Country"
},
"from_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "From Date"
},
"max_search_results": {
"default": 20,
"title": "Max Search Results",
"type": "integer"
},
"mode": {
"default": "on",
"title": "Mode",
"type": "string"
},
"model": {
"default": "grok-4",
"title": "Model",
"type": "string"
},
"prompt": {
"title": "Prompt",
"type": "string"
},
"return_citations": {
"default": true,
"title": "Return Citations",
"type": "boolean"
},
"rss_links": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Rss Links"
},
"sources": {
"anyOf": [
{
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Sources"
},
"system_prompt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "System Prompt"
},
"to_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "To Date"
}
},
"required": [
"prompt"
],
"type": "object"
}