search_cards
Search Magic: The Gathering cards using advanced query strings with support for pagination, sorting, and deduplication. Retrieve card data efficiently for applications or workflows based on specific criteria like type, color, power, or text.
Instructions
通过查询字符串搜索卡牌,支持分页和排序。
查询语法示例:
t:creature c:r
(红色生物)pow>=5 or mv<2
(力量大于等于5或法术力值小于2)o:"draw a card" -c:u
(包含"抓一张牌"的非蓝色牌)(t:instant or t:sorcery) mv<=3
(3费或以下的瞬间或法术)
分页参数:
page
: 页码 (整数, 默认 1)page_size
: 每页数量 (整数, 默认 20, 最大 100)
排序参数:
order
: 按字段排序,逗号分隔。前缀-
表示降序 (例如:name
,-mv
,name,-rarity
) 默认排序:name
其他参数:
unique
: 去重方式 (id, oracle_id, illustration_id)priority_chinese
: 是否优先显示中文卡牌
Input Schema
Name | Required | Description | Default |
---|---|---|---|
order | No | 排序字段 (例如: name, -mv, rarity) | |
page | No | 页码 (默认 1) | |
page_size | No | 每页数量 (默认 20,最大 100) | |
priority_chinese | No | 是否优先显示中文卡牌 (默认 true) | |
q | Yes | 查询字符串,例如 't:creature c:r'、'pow>=5 or mv<2'、's:TDM -t:creature' | |
unique | No | 去重方式: id(不去重), oracle_id(按卡牌名去重), illustration_id(按插图去重) |