ゲームコンテンツツール
エージェント・マップ・武器・スキンなどのVALORANTゲームコンテンツを取得します。画像・アイコンはすべて https://valo.town/ でホストされます。
list_agents
VALORANTのプレイアブルエージェント一覧を取得します。
パラメーター
| 名前 | 型 | デフォルト | 説明 |
|---|---|---|---|
playable_only | bool | true | プレイアブルなエージェントのみ取得 |
レスポンス
json
[
{
"uuid": "a3bfb853-43b2-7238-a4f1-ad90e9e46bcc",
"name_jp": "レイナ",
"name_en": "Reyna",
"role": "デュエリスト",
"description": "...",
"icon_url": "https://valo.town/assets/images/agents/a3bfb853-.../displayicon.webp",
"portrait_url": "https://valo.town/assets/images/agents/a3bfb853-.../fullportrait.webp",
"abilities": [
{
"slot": "Ability1",
"name": "ルーム",
"description": "..."
}
]
}
]使用例
# プレイアブルエージェント一覧
list_agents()
# 全エージェント(非プレイアブル含む)
list_agents(playable_only=false)get_agent_detail
エージェント名で詳細情報を取得します。
パラメーター
| 名前 | 型 | 説明 |
|---|---|---|
name | string | エージェント名(日本語・英語どちらでも可) |
レスポンス
json
{
"uuid": "a3bfb853-43b2-7238-a4f1-ad90e9e46bcc",
"name_jp": "レイナ",
"name_en": "Reyna",
"role": "デュエリスト",
"description": "ジアン・コルテスは一般人に扮し世界各地の武力衝突に潜入する人物だ...",
"icon_url": "https://valo.town/assets/images/agents/.../displayicon.webp",
"portrait_url": "https://valo.town/assets/images/agents/.../fullportrait.webp",
"background_url": "https://valo.town/assets/images/agents/.../background.webp",
"abilities": [
{
"slot": "Ability1",
"name": "ルーム",
"description": "即座に装備し投擲する。接触または短い遅延後に爆発し、周囲のエネミーを短時間盲目にする。",
"icon_url": "https://valo.town/assets/images/agents/.../abilities/..."
},
{
"slot": "Ability2",
"name": "デヴァウア"
},
{
"slot": "Grenade",
"name": "ディスミス"
},
{
"slot": "Ultimate",
"name": "エンプレス"
}
]
}使用例
get_agent_detail(name="レイナ")
get_agent_detail(name="Reyna")
get_agent_detail(name="Jett")list_maps
コンペティティブマップの一覧と説明・画像を取得します。
レスポンス
json
[
{
"uuid": "7eaecc1b-4337-bbf6-6ab9-04b8f06b3319",
"name_jp": "アセント",
"name_en": "Ascent",
"map_url": "/Game/Maps/Ascent/Ascent",
"description": "イタリア・ヴェネツィアを舞台にしたオープンなマップ...",
"splash_url": "https://valo.town/assets/images/maps/7eaecc1b-.../splash.png",
"minimap_url": "https://valo.town/assets/images/maps/7eaecc1b-.../minimap.png",
"coordinates": { "x_multiplier": 0.000102, "y_multiplier": 0.000101, "x_scalar": 0.21, "y_scalar": 0.82 }
}
]map_url は get_match_detail や search_matches の map_id と対応しています。
使用例
list_maps()list_weapons
VALORANTの全武器一覧を取得します。
レスポンス
json
[
{
"uuid": "63e6c2b6-4a8e-869c-3d4c-e38355226584",
"name_jp": "ゴースト",
"name_en": "Ghost",
"category": "Sidearms",
"icon_url": "https://valo.town/assets/images/weapons/63e6c2b6-.../displayicon.png"
}
]武器カテゴリ
| 値 | 説明 |
|---|---|
Sidearms | サイドアーム(ゴースト・シェリフなど) |
SMGs | SMG(スペクター・ストリンガーなど) |
Rifles | ライフル(ヴァンダル・ファントムなど) |
Snipers | スナイパー(オペレーターなど) |
Shotguns | ショットガン |
Machine Guns | マシンガン |
Melee | 近接武器 |
使用例
list_weapons()search_skins
スキン名でバンドル・スキンを検索します。
パラメーター
| 名前 | 型 | デフォルト | 説明 |
|---|---|---|---|
keyword | string | 必須 | スキン名またはバンドル名 |
limit | int | 20 | 取得件数 |
offset | int | 0 | オフセット |
レスポンス
json
{
"total": 12,
"limit": 20,
"offset": 0,
"results": [
{
"uuid": "...",
"name": "プライムシリーズ ヴァンダル",
"bundle_name": "プライム",
"weapon_name": "ヴァンダル",
"icon_url": "https://valo.town/assets/images/skins/.../displayicon.png",
"content_tier": "Exclusive"
}
]
}使用例
# バンドル名で検索
search_skins(keyword="プライム")
# 武器名で検索
search_skins(keyword="ヴァンダル")
# シリーズ横断検索
search_skins(keyword="ネオン", limit=50)