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#

bash

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

bash

python scripts/bumble_client.py auth "<user_phone_number>"

SMS code step#

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

bash

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#

bash

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#

bash

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#

bash

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.