execute_sparql
Execute SPARQL queries on Wikidata to retrieve structured data in JSON format, enabling data extraction and analysis from the knowledge base.
Instructions
Execute a SPARQL query on Wikidata.
You may assume the following prefixes:
PREFIX wd: <http://www.wikidata.org/entity/>
PREFIX wdt: <http://www.wikidata.org/prop/direct/>
PREFIX p: <http://www.wikidata.org/prop/>
PREFIX ps: <http://www.wikidata.org/prop/statement/>
Args:
sparql_query (str): The SPARQL query to execute.
Returns:
str: The JSON-formatted result of the SPARQL query execution. If there are no results, an empty JSON object will be returned.Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sparql_query | Yes |
Implementation Reference
- src/server.py:90-115 (handler)Handler function decorated with @server.tool(), implementing the execution of SPARQL queries on Wikidata Query Service, sending the query via HTTP GET and returning JSON-formatted results. Serves as both handler and registration.
@server.tool() async def execute_sparql(sparql_query: str) -> str: """ Execute a SPARQL query on Wikidata. You may assume the following prefixes: PREFIX wd: <http://www.wikidata.org/entity/> PREFIX wdt: <http://www.wikidata.org/prop/direct/> PREFIX p: <http://www.wikidata.org/prop/> PREFIX ps: <http://www.wikidata.org/prop/statement/> Args: sparql_query (str): The SPARQL query to execute. Returns: str: The JSON-formatted result of the SPARQL query execution. If there are no results, an empty JSON object will be returned. """ url = "https://query.wikidata.org/sparql" async with httpx.AsyncClient() as client: response = await client.get( url, params={"query": sparql_query, "format": "json"} ) response.raise_for_status() result = response.json()["results"]["bindings"] return json.dumps(result)