Skip to content

ゲームコンテンツツール

エージェント・マップ・武器・スキンなどのVALORANTゲームコンテンツを取得します。画像・アイコンはすべて https://valo.town/ でホストされます。

list_agents

VALORANTのプレイアブルエージェント一覧を取得します。

パラメーター

名前デフォルト説明
playable_onlybooltrueプレイアブルなエージェントのみ取得

レスポンス

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

エージェント名で詳細情報を取得します。

パラメーター

名前説明
namestringエージェント名(日本語・英語どちらでも可)

レスポンス

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_urlget_match_detailsearch_matchesmap_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サイドアーム(ゴースト・シェリフなど)
SMGsSMG(スペクター・ストリンガーなど)
Riflesライフル(ヴァンダル・ファントムなど)
Snipersスナイパー(オペレーターなど)
Shotgunsショットガン
Machine Gunsマシンガン
Melee近接武器

使用例

list_weapons()

search_skins

スキン名でバンドル・スキンを検索します。

パラメーター

名前デフォルト説明
keywordstring必須スキン名またはバンドル名
limitint20取得件数
offsetint0オフセット

レスポンス

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)