docs: update cookies agents.md

Signed-off-by: Dmytro Stanchiev <git@dmytros.dev>
This commit is contained in:
2026-04-21 22:05:49 -04:00
parent b6e9501448
commit 45cff20377

View File

@@ -2,16 +2,15 @@
Both Facebook Marketplace and eBay require valid session cookies to bypass bot detection and access listings.
## Cookie Priority Hierarchy
## Cookie Configuration
All scrapers follow this priority order (highest to lowest):
1. **URL Parameter** - Passed directly in API/MCP request (overrides all)
2. **Environment Variable** - Set as `FACEBOOK_COOKIE` or `EBAY_COOKIE`
3. **Cookie File** - Stored in `facebook.json` or `ebay.json` (fallback)
Authenticated scrapers now read cookies only from environment variables:
1. `FACEBOOK_COOKIE`
2. `EBAY_COOKIE`
---
## Facebook Marketplace (`facebook.json`)
## Facebook Marketplace
### Required Cookies
- `c_user`: Your Facebook user ID
@@ -20,65 +19,27 @@ All scrapers follow this priority order (highest to lowest):
- `datr`: Data attribution token
- `sb`: Session browser token
### Setup Methods
### Setup
**Method 1: Cookie File (Lowest Priority)**
1. Log into Facebook in your browser
2. Open Developer Tools → Application/Storage → Cookies
3. Export cookies as JSON array to `facebook.json`
Example `facebook.json`:
```json
[
{
"name": "c_user",
"value": "123456789",
"domain": ".facebook.com",
"path": "/",
"secure": true
}
]
```
**Method 2: Environment Variable**
```bash
export FACEBOOK_COOKIE='c_user=123; xs=token; fr=request'
```
**Method 3: URL Parameter (Highest Priority)**
```
GET /api/facebook?q=laptop&cookies=[{"name":"c_user","value":"123",...}]
```
Use the raw `Cookie` header string copied from an authenticated browser session.
---
## eBay (`ebay.json`)
## eBay
eBay has aggressive bot detection that blocks requests without valid session cookies.
### Setup Methods
### Setup
**Method 1: Cookie File (Lowest Priority)**
1. Log into eBay in your browser
2. Open Developer Tools → Network tab
3. Visit ebay.ca and inspect any request headers
4. Copy the full `Cookie` header value
5. Save as plain text to `ebay.json` (see `ebay.json.example`)
Example `ebay.json`:
```
s=VALUE; ds2=VALUE; ebay=VALUE; dp1=VALUE; nonsession=VALUE
```
**Method 2: Environment Variable**
```bash
export EBAY_COOKIE='s=VALUE; ds2=VALUE; ebay=VALUE'
```
**Method 3: URL Parameter (Highest Priority)**
```
GET /api/ebay?q=laptop&cookies=s=VALUE;ds2=VALUE;ebay=VALUE
```
Use the raw `Cookie` header string copied from an authenticated browser session.
---
@@ -91,4 +52,4 @@ GET /api/ebay?q=laptop&cookies=s=VALUE;ds2=VALUE;ebay=VALUE
## Security
All `*.json` files in this directory are git-ignored for security.</content>
Do not commit real cookie values or store them in tracked files.