captcha-solving-basic

captcha-solving-basic Intuned project

Automation project to demonstrate our captcha solving capabilities

Run on Intuned

Open this project in Intuned by clicking the button below.

Getting Started

To get started developing browser automation projects with Intuned, check out our concepts and terminology.

Development

NOTE: All commands support --help flag to get more information about the command and its arguments and options.

Install dependencies

# npm
npm install

# yarn
yarn

NOTE: If you are using npm, make sure to pass -- when using options with the intuned command.

Run an API

# Run the captcha solver
# npm
npm run intuned run api captcha-solver .parameters/api/captcha-solver/default.json

# yarn
yarn intuned run api captcha-solver .parameters/api/captcha-solver/default.json

Save project

# npm
npm run intuned provision

# yarn
yarn intuned provision

Deploy project

# npm
npm run intuned deploy

# yarn
yarn intuned deploy

@intuned/browser: Intuned Browser SDK

This project uses Intuned browser SDK. For more information, check out the Intuned Browser SDK documentation.

Project Structure

The project structure is as follows:

/
├── apis/                     # Your API endpoints 
│   └── ...   
├── auth-sessions/            # Auth session related APIs
│   ├── check.ts           # API to check if the auth session is still valid
│   └── create.ts          # API to create/recreate the auth session programmatically
├── auth-sessions-instances/  # Auth session instances created and used by the CLI
│   └── ...
└── Intuned.jsonc              # Intuned project configuration file

Intuned.jsonc Reference

{
  // Your Intuned workspace ID. 
  // Optional - If not provided here, it must be supplied via the `--workspace-id` flag during deployment.
  "workspaceId": "your_workspace_id",

  // The name of your Intuned project. 
  // Optional - If not provided here, it must be supplied via the command line when deploying.
  "projectName": "your_project_name",

  // Replication settings
  "replication": {
    // The maximum number of concurrent executions allowed via Intuned API. This does not affect jobs.
    // A number of machines equal to this will be allocated to handle API requests.
    // Not applicable if api access is disabled.
    "maxConcurrentRequests": 1,

    // The machine size to use for this project. This is applicable for both API requests and jobs.
    // "standard": Standard machine size (6 shared vCPUs, 2GB RAM)
    // "large": Large machine size (8 shared vCPUs, 4GB RAM)
    // "xlarge": Extra large machine size (1 performance vCPU, 8GB RAM)
    "size": "standard"
  }

  // Auth session settings
  "authSessions": {
    // Whether auth sessions are enabled for this project.
    // If enabled, "auth-sessions/check.ts" API must be implemented to validate the auth session.
    "enabled": true,

    // Whether to save Playwright traces for auth session runs.
    "saveTraces": false,

    // The type of auth session to use.
    // "API" type requires implementing "auth-sessions/create.ts" API to create/recreate the auth session programmatically.
    // "MANUAL" type uses a recorder to manually create the auth session.
    "type": "API",
    

    // Recorder start URL for the recorder to navigate to when creating the auth session.
    // Required if "type" is "MANUAL". Not used if "type" is "API".
    "startUrl": "https://example.com/login",

    // Recorder finish URL for the recorder. Once this URL is reached, the recorder stops and saves the auth session.
    // Required if "type" is "MANUAL". Not used if "type" is "API".
    "finishUrl": "https://example.com/dashboard",

    // Recorder browser mode
    // "fullscreen": Launches the browser in fullscreen mode.
    // "kiosk": Launches the browser in kiosk mode (no address bar, no navigation controls).
    // Only applicable for "MANUAL" type.
    "browserMode": "fullscreen"
  }
  
  // API access settings
  "apiAccess": {
    // Whether to enable consumption through Intuned API. If this is false, the project can only be consumed through jobs.
    // This is required for projects that use auth sessions.
    "enabled": true
  },

  // Whether to run the deployed API in a headful browser. Running in headful can help with some anti-bot detections. However, it requires more resources and may work slower or crash if the machine size is "standard".
  "headful": false,

  // The region where your Intuned project is hosted.
  // For a list of available regions, contact support or refer to the documentation.
  // Optional - Default: "us"
  "region": "us"
}

Learn More

• Intuned llm.txt