Docs: instruct deployers to set API origin for worker and OpenAPI

- wrangler.toml: comment to set FAIRFETCH_API_ORIGIN to deployer's API base URL
- openapi.yaml: comment and production server description for self-hosting
- PUBLISHER_GUIDE: Cloudflare step must set API origin to created API server
- README: config note and openapi.yaml tree note for self-hosted API URL

Author: arun-fairfetch

README.md

@@ -671,7 +671,7 @@ fairfetch/
 │   └── dev_server.py        # Local launcher (make dev)
 ├── tests/                   # 127 tests · 98% coverage
 ├── .github/workflows/       # CI pipeline
-├── openapi.yaml             # REST API spec
+├── openapi.yaml             # REST API spec (set servers[].url to your API when self-hosting)
 ├── mcp.json                 # MCP Inspector config
 ├── pyproject.toml            # Package config
 ├── Makefile                 # Dev commands
@@ -682,6 +682,8 @@ fairfetch/
 
 ## ⚙️ Configuration
 
+**Deploying your own API?** If you use the Cloudflare Worker (`deploy/cloudflare/wrangler.toml`), set `FAIRFETCH_API_ORIGIN` to your API base URL. If you use the OpenAPI spec for clients or docs, set the production `servers[].url` in `openapi.yaml` to your deployed API.
+
 | Variable | Default | Description |
 |----------|---------|-------------|
 | `FAIRFETCH_TEST_MODE` | `true` | Enable mock facilitator + grants; when `false`, CORS is restricted to your domain and no test wallets are pre-seeded |

deploy/cloudflare/wrangler.toml

@@ -2,6 +2,8 @@ name = "fairfetch-edge"
 main = "worker.ts"
 compatibility_date = "2025-12-01"
 
+# Set FAIRFETCH_API_ORIGIN to the base URL of the Fairfetch API server you run.
+# The worker proxies AI-agent requests to this origin. Replace with your own (e.g. https://fairfetch.co or https://api.yoursite.com).
 [vars]
 FAIRFETCH_API_ORIGIN = "https://api.fairfetch.co"
 FAIRFETCH_LLMS_TXT = "/.well-known/llms.txt"

docs/PUBLISHER_GUIDE.md

@@ -288,7 +288,7 @@ Choose the option that matches how your site is hosted.
 **Best for:** Sites already on Cloudflare.
 
 1. In the Fairfetch repo, go to the folder `deploy/cloudflare`.
-2. Open `wrangler.toml` and set your API origin and paths. **Example:**
+2. Open `wrangler.toml` and set your API origin and paths. **You must set `FAIRFETCH_API_ORIGIN` to the base URL of the Fairfetch API server you have created** (the repo default may be a placeholder). **Example:**
 
 ```toml
 [vars]

openapi.yaml

@@ -26,11 +26,12 @@ info:
     name: Fairfetch
     url: https://github.com/Fairfetch-co/fairfetch
 
+# When hosting your own instance, change the production server URL below to your deployed API base (e.g. https://your-domain.com).
 servers:
   - url: http://localhost:8402
     description: Local development server
   - url: https://api.fairfetch.co
-    description: Production API
+    description: Production API (replace with your API server URL when self-hosting)
 
 paths:
   /content/fetch: