List every Anker power system ("site") linked to this account, keyed by site ID.

    A site groups together the devices installed at one location - e.g. a
    Solarbank, its expansion battery pack, and a Smartmeter. Start here (or
    with list_devices) to discover the IDs needed by the other tools.
    

Get the cached detail record for one site, including whatever current power-flow summary the Anker cloud API reports for it (e.g. solar input, battery charge/discharge, home load, grid import/export).

    Args:
        site_id: The site ID, as returned by list_sites.
    

List every device (Solarbank, expansion battery pack, Smartmeter, etc.) linked to the Anker account, keyed by device serial number.

    Each entry contains whatever fields the Anker cloud API reports for
    that specific device model and firmware version - typically at least a
    name and a type/model field, plus live status fields where available.
    Use this to find device serial numbers (device_sn) for the more
    specific tools like get_solarbank_status and get_smartmeter_status.
    

Get the full cached detail record for one device by serial number, with no type-specific filtering applied.

    Args:
        device_sn: The device serial number, as returned by list_devices.
    

List devices that look like Solarbanks or their expansion battery packs, identified heuristically from model/type/name fields.

    If nothing matches the heuristic, every device is returned instead so
    you can still find the right one by eye - use get_device on any
    serial number for the unfiltered detail record.
    

Get current status for one Solarbank (or expansion battery pack): battery state of charge, solar input power, output power, charge/discharge power, temperature, and any other fields the Anker cloud API reports for this device.

    Args:
        device_sn: The Solarbank's device serial number (see list_solarbanks
            or list_devices).
    

Get the charge/discharge schedule and output-power plan configured for a Solarbank, if the Anker cloud API reports one under this device's cached data.

    Args:
        device_sn: The Solarbank's device serial number (see list_solarbanks
            or list_devices).
    

List devices that look like Anker Smartmeters, identified heuristically from model/type/name fields.

If nothing matches the heuristic, every device is returned instead so you can still find the right one by eye.

Get current status for one Smartmeter: grid import/export power and any other fields the Anker cloud API reports for this device.

    Args:
        device_sn: The Smartmeter's device serial number (see
            list_smartmeters or list_devices).
    

Fetch fresh energy statistics from the Anker cloud API: solar production, battery charge/discharge, grid import/export, and home usage totals, for every site/device the account can see.

    Unlike the other tools, this always makes a live request rather than
    serving the throttled cache, since energy totals are the numbers most
    often asked about ("how much did we produce/use today").
    

Force an immediate refresh of all cached Anker Solix data (sites, devices, and energy), bypassing the normal refresh-interval throttle.

Call this if you suspect other tools are returning stale data - for example right after changing a setting in the Anker app.

Get basic info about the authenticated Anker account (e.g. nickname, account/email identifiers), with any credentials or tokens redacted.