This extends the public API by adding a new module MiotSpec with the following new class methods:

• get_specs() to get list of all available specs, containing device urns and version information
• get_spec_for_urn(device_urn) to get a spec for the given device urn
• get_standard_types(type) to get list of standardized elements for a given "type" (devices, properties, actions, ..)
• get_standard_type_spec(type_urn) to get the spec for a standardized element

These methods can be used to obtain information to create generic interfaces based on the response metadata, see rytilahti/python-miio#1581 for an example use-case.

The cli tool is extended with a new sub-command (miot) that can be used to access this functionality (unfortunately, the existing get-devices has now to be called explicitly...):

❯ micloud
Usage: micloud [OPTIONS] COMMAND [ARGS]...

  Tool for fetching xiaomi cloud information.

Options:
  --help  Show this message and exit.

Commands:
  get-devices  Get device information, including tokens.
  miot         Commands for miotspec fetching.

which allows accessing the new functionalities:

❯ micloud miot
Usage: micloud miot [OPTIONS] COMMAND [ARGS]...

  Commands for miotspec fetching.

Options:
  --help  Show this message and exit.

Commands:
  get-spec       Return a device spec for the given URN.
  get-type-spec  Return a type spec for given type URN.
  specs          Return all specs filtered by the given status.
  types          Return available standard URNs for type.

The new commands return JSON so that the output can be passed to jq or other tools that can consume JSON.

Open questions:

• Naming of the methods?
• If wanted, the old way of calling cli tool without get-devices could be added
• Session re-using? I added reset=True to reset the session for every request to avoid passing all extra headers potentially added by the existing functionality

URLs to fetch the data were found at https://gist.github.com/marcelrv/20509106e97b4c7dd8c9056aefda2332 – thanks @marcelrv