Overview

Last updated: April 11, 2026

WoWCheck Module Overview (wowcheck)

The wowcheck package provides specialized integrations for querying World of Warcraft (WoW) character data, armory prices, and game telemetry.

Key Features

  • Character Lookup: Queries external APIs (like Raider.IO or Blizzard APIs) to retrieve character item levels, achievements, and progression.
  • Auction House (AH) Lookup: Fetches current market prices for WoW items (gold, silver, copper).
  • Assistant Bridge: The wow_tool_bridge.go file exposes these capabilities as tools (wow_character_lookup, wow_ah_price_lookup) for the assistant module.

Key Files

  • wowcheck/wowcheck.go: The core logic and API client for WoW data.
  • wowcheck/wow_tool_bridge.go: The adapter that registers WoW capabilities as tools within the assistant ecosystem.

Integration Flow

  1. Tool Invocation: An agent (e.g., nikki) decides to use the wow_character_lookup tool.
  2. Bridge: The request hits assistant.wow_character_lookup, which formats the arguments and calls wowcheck.
  3. API Call: wowcheck.go makes the external HTTP request to the gaming APIs.
  4. Formatting: The raw JSON is parsed into a clean summary (Level, Item Level, Achievements).
  5. Return: The data is returned as a ToolResult for the agent to analyze.

Guidance for AI Agents

  • Character Mapping: Be aware that users often have multiple characters. Ensure you specify the correct character_name, realm, and region when using the lookup tools.
  • Data Freshness: API data might have a slight delay compared to live in-game status.

Cross-References