Bumble Client

Session policy

• Always start from https://bumble.com/app.
• Reuse the existing bumble session whenever possible.
• If Bumble is already authenticated, do not run the auth flow again.
• If you gettin get-started or auth pages then start "Auth flow"
• Re-authenticate only when Bumble is clearly on get-started, auth, or SMS-confirmation pages.
• For non-auth actions, resume the stored session only; if Bumble is logged out, return an error instead of triggering auth.
• If Bumble is on a CAPTCHA screen, do not treat that as a normal logged-in state.
• If Bumble reaches a passkey screen after SMS verification, only Not Now may be used automatically; do not create or enroll a passkey automatically.
• Do not log out unless there is a significant reason.
• Use random 1–4 sec pauses between actions.
• Set location to San Francisco (37.79, -122.42) after session start.

Local debug / inspection

python scripts/bumble_client.py state    # returns JSON
python scripts/bumble_client.py debug
python scripts/bumble_client.py matches  # JSON: matches[{name, expired}], expired true/false/null, counts
python scripts/bumble_client.py likes    # JSON: visible likes plus Beeline count/premium signal when available
python scripts/bumble_client.py messages "Kritika"  # returns JSON with author field
python scripts/bumble_client.py send "Kritika" "message text"
python scripts/bumble_client.py photos "Kritika" "/absolute/output/dir"

Match selection policy

• Always switch matches from the left conversation bar.
• Do not assume the click worked just because the action returned 200.
• Verify that the active profile / conversation on the right changed to the requested match name.
• If the requested name is wrong or the active profile name does not match exactly, return an error instead of silently using the previously open match.

Auth flow

Only when on get-started or auth page:

1. Tap "Continue with other methods" — selectors: div.other-methods-button, span.other-methods-button-text
2. Tap "Use cell phone number" — selectors: span.action.text-break-words, button.primary.button--transparent span.action
3. Ask the user to provide their phone number, then type that number (national digits; country is chosen in the UI) into the digits field and pass the same number on the CLI
4. Tap "Continue"
5. Stop on the SMS confirmation page and wait for a code

python scripts/bumble_client.py auth "\x3Cuser_phone_number>"

SMS code step

Only when Bumble is already on the confirm-phone page:

python scripts/bumble_client.py sms_code 233596

Current behavior:

• First tries the working fallback: type the full 6-digit code into the first OTP box.
• Prefer focusing the first OTP box once and typing the whole code without selecting each field individually.
• Falls back to per-digit entry if needed.
• Only reports success if Bumble actually leaves the confirm-phone page.
• If the SMS code is accepted but Bumble moves to a CAPTCHA challenge, return:
  • state: "captcha_challenge"
  • sms_code_accepted: true
  • an error saying manual CAPTCHA completion is required
• If the SMS code is accepted and Bumble moves to /registration/passkey, the client taps Not Now (skip for now). Do not tap Create a passkey or complete passkey enrollment automatically. open_connections also attempts the same skip if a stored session resumes on that screen.

Messages

python scripts/bumble_client.py messages "Kritika"

• Returns JSON.
• Includes author for each message (me / them when HTML parsing succeeds).
• Should not trigger auth automatically.

Send message

python scripts/bumble_client.py send "Kritika" "message text"

• Opens the requested match.
• Verifies Bumble accepted the draft before sending.
• Sends using the actual code path in bumble_client.py:
  • resolve send button bounds
  • tap/click by coordinates at the button center
  • fall back to accessibility-ref click only if needed
• Verifies the sent message appears in the visible thread before reporting success.

Profile photos

python scripts/bumble_client.py photos "Anya" "/absolute/output/dir"

• Opens the requested match and verifies the right-side active profile name matches exactly.
• Taps the right-side profile photo area.
• Performs a best-effort photo advance/tap loop.
• Extracts unique Bumble CDN photo URLs from the active profile HTML.
• Downloads the photos into the provided directory.
• Resets back to the normal match thread view after export.