From 45cff203776467f2a886443ebe52f2847b02349c Mon Sep 17 00:00:00 2001
From: Dmytro Stanchiev <git@dmytros.dev>
Date: Tue, 21 Apr 2026 22:05:49 -0400
Subject: [PATCH] docs: update cookies agents.md

Signed-off-by: Dmytro Stanchiev <git@dmytros.dev>
---
 cookies/.ruler/AGENTS.md | 61 ++++++++--------------------------------
 1 file changed, 11 insertions(+), 50 deletions(-)

diff --git a/cookies/.ruler/AGENTS.md b/cookies/.ruler/AGENTS.md
index d6fd952..79ff7a8 100644
--- a/cookies/.ruler/AGENTS.md
+++ b/cookies/.ruler/AGENTS.md
@@ -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.