wikidata-search
在Wikidata上搜索项目和属性并检索外部标识符。当代理需要(1)通过标签或别名搜索Wikidata项目,(2)获取实体详情,包括标签、描述、别名,(3)检索实体的外部标识符(权威控制ID),(4)查找项目的属性或声明时使用。触发于提及Wikidata、Q-IDs、P-IDs、权威控制、外部标识符或结构化知识库查询的查询。
📖 中文导读:在Wikidata上搜索项目和属性并检索外部标识符。当代理需要(1)通过标签或别名搜索Wikidata项目,(2)获取实体详情,包括标签、描述、别名,(3)检索实体的外部标识符(权威控制ID),(4)查找项目的属性或声明时使用。触发于提及Wikidata、Q-IDs、P-IDs、权威控制、外部标识符或结构化知识库查询的查询。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: wikidata-search description: Search for items and properties on Wikidata and retrieve external identifiers. Use when an agent needs to (1) search for Wikidata items by label or alias, (2) get entity details including labels, descriptions, aliases, (3) retrieve external identifiers (authority control IDs) for an entity, (4) look up properties or claims for items. Triggers on queries mentioning Wikidata, Q-IDs, P-IDs, authority control, external identifiers, or structured knowledge base lookups.
Wikidata Search Skill
Search and retrieve data from Wikidata, the free knowledge base.
API Endpoint
Base URL: https://www.wikidata.org/w/api.php
Core Functions
1. Search Items (wbsearchentities)
Search for entities by label or alias.
curl 'https://www.wikidata.org/w/api.php?action=wbsearchentities&search=QUERY&language=en&format=json&type=item&limit=10'
Parameters:
search: Search term (required)language: Language code (default: en)type:item(Q-entities) orproperty(P-entities)limit: Max results (1-50, default: 7)continue: Offset for pagination
Response fields per result:
id: Entity ID (e.g., Q42)label: Primary labeldescription: Short descriptionaliases: Alternative namesurl: Wikidata page URL
2. Get Entity Details (wbgetentities)
Retrieve full entity data including claims/identifiers.
curl 'https://www.wikidata.org/w/api.php?action=wbgetentities&ids=Q42&format=json&props=labels|descriptions|aliases|claims'
Parameters:
ids: Pipe-separated entity IDs (max 50)props:labels|descriptions|aliases|claims|sitelinks|infolanguages: Filter languages (e.g.,en|fr|de)
3. Get Claims Only (wbgetclaims)
Retrieve claims for specific entity/property.
curl 'https://www.wikidata.org/w/api.php?action=wbgetclaims&entity=Q42&property=P31&format=json'
Extracting External Identifiers
External identifiers are stored as claims with datatype external-id. Common identifier properties:
| Property | Name | Example |
|---|---|---|
| P214 | VIAF ID | 75121530 |
| P227 | GND ID | 119033364 |
| P244 | Library of Congress ID | n79023811 |
| P213 | ISNI | 0000 0001 2144 9326 |
| P345 | IMDb ID | nm0001354 |
| P646 | Freebase ID | /m/0282x |
| P349 | NDL ID | 00621256 |
| P268 | BnF ID | 11888092r |
| P269 | IdRef ID | 026927608 |
| P906 | SELIBR ID | 182099 |
| P396 | SBN author ID | IT\ICCU\CFIV\000163 |
To extract identifiers from wbgetentities response:
# claims = response['entities']['Q42']['claims']
# For each property P:
# claims[P][0]['mainsnak']['datavalue']['value'] -> identifier string
Python Script Usage
Use scripts/wikidata_api.py for programmatic access:
from scripts.wikidata_api import WikidataAPI
wd = WikidataAPI()
# Search for items
results = wd.search("Albert Einstein", language="en", limit=5)
# Get entity with identifiers
entity = wd.get_entity("Q937", props=["labels", "descriptions", "claims"])
# Get external identifiers only
identifiers = wd.get_identifiers("Q937")
# Returns: {'P214': '75121530', 'P227': '118529579', ...}
Response Handling
Search Response Structure
{
"searchinfo": {"search": "query"},
"search": [
{
"id": "Q42",
"label": "Douglas Adams",
"description": "English writer and humorist",
"aliases": ["Douglas Noël Adams"],
"url": "//www.wikidata.org/wiki/Q42"
}
]
}
Entity Response Structure
{
"entities": {
"Q42": {
"type": "item",
"id": "Q42",
"labels": {"en": {"language": "en", "value": "Douglas Adams"}},
"descriptions": {"en": {"language": "en", "value": "..."}},
"claims": {
"P31": [...], // instance of
"P214": [{"mainsnak": {"datavalue": {"value": "113230702"}}}] // VIAF
}
}
}
}
Best Practices
- Rate limiting: Add 500ms-1s delay between requests
- Batch requests: Use pipe-separated IDs (max 50 per request)
- Set User-Agent: Include contact info in headers
- Filter props: Request only needed properties to reduce payload
- Handle missing data: Not all entities have all properties