Bumble Client

Intended use

This skill drives the operator's own Bumble web account inside a remote browser the

operator already owns. It is intended for personal automation: resuming the user's

session, listing the user's own matches and likes, reading and sending messages

where the user already has the right to chat, and exporting photos that the user's

account is already authorized to view.

It does not:

• create new Bumble accounts
• crack, brute-force, or bypass any Bumble authentication step
• defeat CAPTCHA or any anti-abuse defense (CAPTCHA screens halt the flow and

require the human operator to solve them)

• automate any messaging that the Bumble backend does not already permit
• collect data from anyone other than the operator's own match list

The phone number and SMS code are supplied by the operator, not generated.

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, source, expired, conversation_expired}], counts; conversation_expired true/false for conversations, null for queue
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"
# For URLs or newlines, avoid shell ANSI-C quoting ($'…'); use stdin or a file:
printf '%s\n' '3pm Saturday works? https://example.com/map' | python scripts/bumble_client.py send "Kritika" -
python scripts/bumble_client.py send "Kritika" --file /path/to/message.txt
python scripts/bumble_client.py unmatch "Kritika"
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.
• Unmatch is under the chat header sandwich (⋮) menu on the right (first icon; generic-menu in the DOM), then Unmatch in that menu. Bumble then shows a modal: choose the Unmatch row (not “Block and report”), then confirm any follow-up prompts.

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 "<user_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 Bumble's official Not Now button to decline the optional passkey-enrollment prompt. The client never creates, registers, or stores a passkey; it only declines the prompt so the user is not pressured into enrolling a passkey on a remote device. open_connections also declines this prompt 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"
# For URLs or newlines, avoid shell ANSI-C quoting ($'…'); use stdin or a file:
printf '%s\n' '3pm Saturday works? https://example.com/map' | python scripts/bumble_client.py send "Kritika" -
python scripts/bumble_client.py send "Kritika" --file /path/to/message.txt

• 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.