# Semi-automatic

**Repository Path**: jackgoogle/semi-automatic

## Basic Information

- **Project Name**: Semi-automatic
- **Description**: 半自动注册助手
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-15
- **Last Updated**: 2026-06-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Semi-automatic registration helper

This project provides a Playwright-based helper for the France-Visas registration page.

It is intentionally semi-automatic:

- It can fill basic form fields such as name, email, password, and language.
- It does not solve, bypass, or outsource CAPTCHA/security-code challenges.
- It does not click the final registration button automatically.
- The user must manually review the form, enter the security code, and decide whether to submit.

## Requirements

- Node.js 18+
- npm

## Install

```bash
npm install
npx playwright install chromium
```

## Configure applicant data

Copy the example file:

```bash
cp data/applicant.example.json data/applicant.local.json
```

Edit `data/applicant.local.json`:

```json
{
  "registrationUrl": "https://connect.france-visas.gouv.fr/realms/usager/login-actions/registration?client_id=fv-fo-keycloak-web",
  "lastName": "ZHANG",
  "firstName": "SAN",
  "email": "name@example.com",
  "password": "ChangeMe123!",
  "languageLabel": "中文"
}
```

Do not commit files containing real personal data or real passwords.

## Run

```bash
APPLICANT_JSON=data/applicant.local.json npm start
```

On Windows Git Bash, the same command works. In PowerShell, use:

```powershell
$env:APPLICANT_JSON="data/applicant.local.json"; npm start
```

## Behavior

The browser opens visibly, fills fields where matching selectors are found, then pauses. At that point you should:

1. Review all filled fields.
2. Manually type the security code shown on the page.
3. Submit only if everything is correct and you are authorized to create the account.
4. Close the browser window when finished.

## Safety boundary

Use this helper only for personal, authorized, or internal testing scenarios. Do not use it for bulk account creation, CAPTCHA bypassing, credential stuffing, or any activity that violates a website's terms.