
## Installation

You can install Euler Flow from the [Chrome Web Store](https://chromewebstore.google.com/detail/-/gcbbaikjfjmidabapdnebofcmconhdbn?hl=end) or [GitHub Project](https://github.com/EulerStream/Euler-Flow).

## Getting Started

To set up the CAPTCHA extension, visit the intuitive dashboard provided with the client.

Here's how you get there:

![Dashboard](/remote/captchas/open-ext.png)

## Enabling CAPTCHAs

CAPTCHA solving is included with every Business and Enterprise plan, with no add-on, credits or
per-solve fees. Each plan has a daily allotment of solutions, from 1,000 a day on Business 10K to
20,000 a day on Business 200K, and the free Community plan has 10 a day. Compare every plan on the
[Pricing page](/pricing).

## License

This extension is licensed under the [MIT License](https://opensource.org/license/mit/).

## Automating With Headless Frameworks

With headless browsers, the Euler Stream auth flow doesn't make much sense, so we provide a simple way to automate it.

### Method #1: Using x-api-key Query Parameter

Pass `x-api-key` to whatever page you want to automate on TikTok.

For example, `https://www.tiktok.com/explore?x-api-key=YOUR_API_KEY_HERE`.

### Method #2: Set it with Selenium (More Secure)

```py
from selenium import webdriver

driver = webdriver.Chrome()

# 1. Override the local storage item for the extension.
driver.execute_cdp_cmd("Storage.setLocalStorageItem", {
    "origin": "chrome-extension://gcbbaikjfjmidabapdnebofcmconhdbn/",
    "key": "app-settings",
    "key": "x-api-key",
    "value": "\"YOUR_API_KEY_HERE\""
})

# 2. Provide your own CAPTCHA server, if you'd like.
driver.execute_cdp_cmd(
    "Storage.setLocalStorageItem",
    {
        "origin": "chrome-extension://gcbbaikjfjmidabapdnebofcmconhdbn/",
        "key": "x-server-url",
        "value": "\"https://my-server.example.com\""  # JSON string
    }
)
```

### Method #3: Set it with Puppeteer (More Secure)

```ts
import puppeteer from "puppeteer";

(async () => {
  // Replace with your extension ID
  const EXT_ID = "gcbbaikjfjmidabapdnebofcmconhdbn";

  // 1. Override the local storage item for the extension.
  await client.send("Storage.setLocalStorageItem", {
    origin: `chrome-extension://${EXT_ID}/`,
    key: "x-api-key",
    value: `"YOUR_API_KEY_HERE"` // JSON-encoded string
  });

  // 2. Provide your own CAPTCHA server, if you'd like.
  await client.send("Storage.setLocalStorageItem", {
    origin: `chrome-extension://${EXT_ID}/`,
    key: "x-server-url",
    value: `"https://my-server.example.com"`
  });

})();
```