Amp Free Trigger

A Cloudflare Worker to toggle Amp Free on/off via API. Amp Free is an ad-supported mode that provides $10/day of free usage across all Amp modes.

Enjoy free web search and oracle agent, ads only appear when you trigger free mode.

See the Example: AGENTS.md for AI Agents section on how to let Ampcode know when to trigger Amp Free.

Prerequisites

• Node.js (v18+)
• Cloudflare account

Installation

1. Install dependencies:

   npm install

2. Install Wrangler CLI globally (if not already installed):

   npm install -g wrangler

3. Login to Cloudflare:

   wrangler login

Configuration

Environment Variables

Variable	Description
GAESA	GAESA cookie from ampcode.com
SESSION	Session cookie from ampcode.com
APIKEY	API key to authenticate worker calls

How to Get Cookies

1. Go to ampcode.com and log in
2. Open DevTools (F12) → Application → Cookies → https://ampcode.com
3. Copy the values of GAESA and session cookies

Deployment

npm run deploy

After deployment, note the URL in the output (e.g., https://amp-free-trigger.your-subdomain.workers.dev). Use this URL for the API calls below.

Set Secrets

Set secrets using Wrangler (you'll be prompted to enter each value):

wrangler secret put GAESA
wrangler secret put SESSION
wrangler secret put APIKEY

Or bulk upload from a JSON file:

cp secrets-example.json secrets.json
# Edit secrets.json with your actual values
wrangler secret bulk secrets.json

Usage

Enable Amp Free

curl -H "x-api-key: YOUR_API_KEY" https://amp-free-trigger.your-subdomain.workers.dev/enable

Disable Amp Free

curl -H "x-api-key: YOUR_API_KEY" https://amp-free-trigger.your-subdomain.workers.dev/disable

API Endpoints

Endpoint	Description
/enable	Enable Amp Free
/disable	Disable Amp Free

All endpoints require the x-api-key header for authentication.

Example: AGENTS.md for AI Agents

Use this worker to enable Amp Free before expensive operations to save money. Add this to your AGENTS.md:

## Free Mode Protocol

Free mode uses free credits for expensive operations to save money. **You MUST enable free mode before and disable after** using these tools:

- `web_search`
- `read_web_page`
- `oracle`

### How to use

**Enable** before the first call:
```bash
curl -s -H "x-api-key: key69" amp-free-trigger.huy023156.workers.dev/enable
```

**Disable** after all operations complete:
```bash
curl -s -H "x-api-key: key69" amp-free-trigger.huy023156.workers.dev/disable
```

### Rules

1. For multiple operations in a batch, only enable/disable **once** around the entire batch
2. Always disable after you're done — don't leave free mode on
3. If you forget to enable beforehand, enable immediately before the next call

Local Development

1. Copy the example env file:

   cp .dev.vars.example .dev.vars

2. Edit .dev.vars and replace the placeholder values with your actual credentials:

   GAESA=your-actual-gaesa-cookie
   SESSION=your-actual-session-cookie
   APIKEY=your-chosen-api-key
   

3. Start the dev server:

   npm run dev

License

MIT