Skip to content

galiprandi/job-seeker / .agents/skills/browser-automation

browser-automation

Verified

Control a dedicated browser via agent-browser (Vercel). Use when automating web apps, scraping authenticated sites, filling forms, or navigating SPAs. Do NOT use for desktop apps or API-only integrations.

FileKindSize
SETUP.mdmarkdown3.0 KB
SKILL.mdskill md39.4 KB
references/agent-browser.mdmarkdown4.6 KB
references/api-capture.mdmarkdown1.8 KB
references/ats-patterns.mdmarkdown4.5 KB
references/audio-transcription.mdmarkdown2.4 KB
references/custom-combobox.mdmarkdown5.0 KB
references/efficiency-patterns.mdmarkdown2.6 KB
references/golden-rules.mdmarkdown5.7 KB
references/key-patterns.mdmarkdown4.4 KB
references/network-console.mdmarkdown1.2 KB
references/parallel-agents.mdmarkdown6.2 KB
references/profile-management.mdmarkdown6.3 KB
references/token-extraction.mdmarkdown2.8 KB
scripts/README.mdmarkdown6.0 KB
scripts/agent-browser.template.jsonconfig333 B
scripts/browser-share.jsscript20.0 KB
scripts/browser.jsexecutablescript17.1 KB
scripts/teams.jsscript7.1 KB
scripts/test-find-guide.jsscript6.3 KB
scripts/transcribe-audio.jsscript3.6 KB
scripts/viewer.htmlother8.6 KB
sites/CONTRIBUTING.mdmarkdown11.0 KB
sites/LEARN.mdmarkdown5.4 KB
sites/afip_gob_ar/guide.mdmarkdown9.0 KB
sites/app_web3forms_com/guide.mdmarkdown7.1 KB
sites/buk_co/guide.mdmarkdown1.5 KB
sites/calendar_google_com/calendar-deeplink.mdmarkdown1.9 KB
sites/calendly_com/guide.mdmarkdown1001 B
sites/careers_epam_com/guide.mdmarkdown4.4 KB
sites/dash_cloudflare_com/guide.mdmarkdown7.7 KB
sites/discord_com/guide.mdmarkdown9.9 KB
sites/discord_com/login-flow.mdmarkdown3.2 KB
sites/docs_google_com/guide.mdmarkdown7.3 KB
sites/facebook_com/guide.mdmarkdown9.8 KB
sites/gmail_com/guide.mdmarkdown35.6 KB
sites/google_com/guide.mdmarkdown1.1 KB
sites/google_com/login-flow.mdmarkdown3.3 KB
sites/google_home_com/guide.mdmarkdown2.1 KB
sites/google_maps_com/guide.mdmarkdown8.4 KB
sites/groq_com/signup-apikey.mdmarkdown6.6 KB
sites/humand_co/guide.mdmarkdown6.9 KB
sites/jira_com/guide.mdmarkdown10.8 KB
sites/linkedin_com/guide.mdmarkdown27.4 KB
sites/linkedin_com/outreach-strategy.mdmarkdown1.2 KB
sites/linkedin_com/posting.mdmarkdown14.0 KB
sites/linkedin_com/voyager-api.mdmarkdown8.1 KB
sites/mercadolibre_com/guide.mdmarkdown4.5 KB
sites/onstrider_com/draftjs-editor-fill.mdmarkdown2.3 KB
sites/onstrider_com/guide.mdmarkdown11.3 KB
sites/onstrider_com/react-autocomplete-inputs.mdmarkdown4.0 KB
sites/outlook_office_com/calendar-deeplink.mdmarkdown2.2 KB
sites/outlook_office_com/guide.mdmarkdown14.0 KB
sites/property_directory/guide.mdmarkdown3.7 KB
sites/reddit_com/guide.mdmarkdown16.2 KB
sites/teams_com/guide.mdmarkdown10.3 KB
sites/teamtailor_com/guide.mdmarkdown6.5 KB
sites/vea_com_ar/guide.mdmarkdown8.8 KB
sites/whatsapp_com/guide.mdmarkdown21.3 KB
sites/whatsapp_com/login-flow.mdmarkdown3.0 KB
sites/whatsapp_com/message-extraction.mdmarkdown5.7 KB
sites/whatsapp_com/voice-notes.mdmarkdown7.1 KB
sites/workatastartup_com/guide.mdmarkdown1.5 KB

sites/groq_com/signup-apikey.md

View on GitHub
---
name: groq-signup-apikey
description: Create a Groq account and generate an API key for transcription (Whisper) or LLM inference. Use when a user needs a free Groq API key for audio transcription or chat completions.
domains:
  - groq.com
  - console.groq.com
---

# Groq — Account Signup & API Key Creation

## When to use

You need a Groq API key to use Groq's free inference API (Whisper transcription, LLM chat completions). This guide covers the full signup flow and API key creation from scratch.

## Prerequisite

- A browser session (headed recommended — a captcha may appear).
- An email address the user can receive mail at (magic-link login).

## Step 1: Navigate to Groq Console

```
https://console.groq.com
```

The landing page shows a "Create Account or Login" panel with four options:

- **Continue with Google** (OAuth)
- **Continue with GitHub** (OAuth)
- **Continue with SSO**
- **Continue with email** (magic link)

## Step 2: Sign up / Log in

### Option A: Email (magic link) — recommended for automation

1. Fill the email input (placeholder: `example@email.com`):

```bash
# Semantic-first: fill by placeholder
node .agents/skills/browser-automation/scripts/browser.js exec find placeholder "example@email.com" fill "user@email.com"
# Fallback: snapshot -i for the input ref, then fill it
node .agents/skills/browser-automation/scripts/browser.js exec snapshot -i
node .agents/skills/browser-automation/scripts/browser.js exec fill "@<email_ref>" "user@email.com"
```

2. Click "Continue with email":

```bash
node .agents/skills/browser-automation/scripts/browser.js exec find text "Continue with email" click
```
3. The page shows "Check your email" with the address confirmation.
4. Open the user's inbox, find the email from Groq titled "Your login request to Groq".
5. Extract the magic link from the "Log in" button href:

```js
// run via: browser.js exec eval "<snippet>"
(() => {
  const link = Array.from(document.querySelectorAll('a')).find(a =>
    a.textContent.trim() === 'Log in' && a.href.includes('stytch.com/v1/magic_links/redirect')
  );
  return link ? link.href : 'not found';
})()
```

6. Navigate to that URL in the browser. The redirect chain is:
   `stytch.com/v1/magic_links/redirect?...` → `console.groq.com/authenticate?stytch_redirect_type=login` → `console.groq.com/home`

7. Wait for the dashboard to load. Verify success by checking for the organization selector:

```js
// run via: browser.js exec eval "<snippet>"
(() => {
  const btn = document.querySelector('[data-testid="organization-selector"]');
  return btn ? 'logged in' : 'not logged in';
})()
```

### Option B: Google OAuth

1. Click "Continue with Google":

```bash
node .agents/skills/browser-automation/scripts/browser.js exec find text "Continue with Google" click
```

2. Google's account chooser appears. Select the account.
3. A consent screen appears ("Google permitirá que Groq acceda a esta información"). Click "Continuar".
4. The redirect may fail with a `400` error on `api.groq.com/platform/v1/user/profile/signupb2b`. If this happens, fall back to the email magic-link flow (Option A).

**Note:** Google OAuth signup was observed to fail with a `400` from `signupb2b` on 2026-08-21. The email magic-link flow worked reliably.

## Step 3: Navigate to API Keys

Once logged in, go to:

```
https://console.groq.com/keys
```

Or click `link "API Keys"` in the left navigation.

## Step 4: Create an API Key

1. Click "Create API Key" (`data-testid="keys-page-create-button"`):

```bash
node .agents/skills/browser-automation/scripts/browser.js exec find text "Create API Key" click
```

2. A dialog appears with:
   - Display Name input (`data-testid="key-name-input"`) — fill with a descriptive name (max 50 chars):

```bash
node .agents/skills/browser-automation/scripts/browser.js exec fill "[data-testid=key-name-input]" "descriptive name"
```

   - Expiration combobox (`data-testid="key-expiration-select"`) — defaults to "No expiration".

3. **Captcha:** Groq may display a captcha (Turnstile) before the Submit button appears. The captcha is not in the accessibility snapshot — check for it visually. The user must solve it manually in a headed browser.

4. After the captcha is solved, the Submit button (`data-testid="key-form-submit-button"`) appears in the dialog. Click it:

```bash
node .agents/skills/browser-automation/scripts/browser.js exec find text "Submit" click
```

5. The response shows:
   - A message: "Your new API key has been created. Copy it now, as we will not display it again."
   - An input containing the key (starts with `gsk_`).
   - A "Copy" button.

6. Extract the key value:

```js
// run via: browser.js exec eval "<snippet>"
(() => {
  const input = document.querySelector('[role="dialog"] input[readonly], [role="dialog"] input:not([placeholder])');
  return input ? input.value : 'not found';
})()
```

7. Click "Done" to close the dialog:

```bash
node .agents/skills/browser-automation/scripts/browser.js exec find text "Done" click
```

## Step 5: Store the API key

The key starts with `gsk_` followed by an alphanumeric string. Store it as an environment variable:

```bash
export GROQ_API_KEY="gsk_..."
```

Add it to a `.env` file or shell profile. **Never commit the key to a repository.**

## Verification

Test the key with a simple transcription request:

```bash
curl -s -X POST "https://api.groq.com/openai/v1/audio/transcriptions" \
  -H "Authorization: Bearer $GROQ_API_KEY" \
  -F "file=@<AUDIO_FILE>" \
  -F "model=whisper-large-v3" \
  -F "language=es" \
  -F "response_format=json"
```

A valid key returns:

```json
{"text":" <transcribed text>","x_groq":{"id":"req_..."}}
```

An invalid key returns `401 Unauthorized`.

## Anti-patterns

- **Do not** use Google OAuth if it fails with `400 signupb2b` — fall back to email magic link.
- **Do not** close the dialog before copying the key — Groq only shows it once.
- **Do not** hardcode the key in scripts or documentation. Use environment variables.
- **Do not** assume the captcha won't appear — always run headed when creating keys for the first time.

## Notes

- The free tier (Developer plan) is immediately active after signup. No payment information required.
- API keys are scoped to the organization, not the individual user.
- The magic link expires in 1 hour.
- If the magic link is opened in a new tab, the original tab may not detect the session. Navigate to the magic link URL directly in the same tab.
- Available transcription models: `whisper-large-v3`, `whisper-large-v3-turbo` (faster, similar accuracy).

**Validated:** 2026-08-21 against live `console.groq.com` with email magic-link flow and `whisper-large-v3-turbo` transcription.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 323kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 323kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 323kUpdated Claude CodeCodexVerifiedInstall