Skip to content

Give your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.

feat: add 'agent-reach configure xhs-cookies' command (#108) (#113)

Pnant4b7d55111f5c
diff --git a/agent_reach/cli.py b/agent_reach/cli.py
index 6de350e1..45d52ba3 100644
--- a/agent_reach/cli.py
+++ b/agent_reach/cli.py
@@ -73,7 +73,8 @@ def main():
p_conf = sub.add_parser("configure", help="Set a config value or auto-extract from browser")
p_conf.add_argument("key", nargs="?", default=None,
choices=["proxy", "github-token", "groq-key",
- "twitter-cookies", "youtube-cookies"],
+ "twitter-cookies", "youtube-cookies",
+ "xhs-cookies"],
help="What to configure (omit if using --from-browser)")
p_conf.add_argument("value", nargs="*", help="The value(s) to set")
p_conf.add_argument("--from-browser", metavar="BROWSER",
@@ -879,6 +880,9 @@ def _cmd_configure(args):
print(f"✅ YouTube cookie source configured: {value}")
print(" yt-dlp will use cookies from this browser for age-restricted/member videos.")
+ elif args.key == "xhs-cookies":
+ _configure_xhs_cookies(value)
+
elif args.key == "github-token":
config.set("github_token", value)
print(f"✅ GitHub token configured!")
@@ -888,6 +892,171 @@ def _cmd_configure(args):
print(f"✅ Groq key configured!")
+def _configure_xhs_cookies(value):
+ """Import cookies into xiaohongshu-mcp Docker container.
+
+ Accepts two formats:
+ 1. Cookie-Editor JSON export (array of cookie objects)
+ 2. Header String: "name1=value1; name2=value2; ..."
+
+ The xiaohongshu-mcp container stores cookies at $COOKIES_PATH
+ (default: /app/data/cookies.json or cookies.json in workdir).
+ Format: JSON array of {name, value, domain, path, expires, httpOnly, secure, sameSite}.
+ """
+ import json
+ import shutil
+ import subprocess
+
+ value = value.strip()
+ if not value:
+ print("[X] Missing cookie value.")
+ print(" Usage: agent-reach configure xhs-cookies '<cookie JSON or header string>'")
+ return
+
+ # Detect format and parse
+ cookies_json = None
+
+ # Try JSON format first (Cookie-Editor JSON export)
+ if value.startswith("["):
+ try:
+ parsed = json.loads(value)
+ if isinstance(parsed, list) and parsed:
+ # Validate it looks like cookie objects
+ first = parsed[0]
+ if isinstance(first, dict) and "name" in first and "value" in first:
+ cookies_json = json.dumps(parsed)
+ print(f" Parsed {len(parsed)} cookies from JSON format")
+ else:
+ print("[X] JSON array doesn't contain cookie objects (need name/value fields)")
+ return
+ else:
+ print("[X] Empty or invalid JSON array")
+ return
+ except json.JSONDecodeError as e:
+ print(f"[X] Invalid JSON: {e}")
+ return
+
+ # Header String format: "key1=val1; key2=val2; ..."
+ if cookies_json is None and "=" in value:
+ cookies = []
+ for part in value.split(";"):
+ part = part.strip()
+ if "=" not in part:
+ continue
+ name, val = part.split("=", 1)
+ name = name.strip()
+ val = val.strip()
+ if name:
+ cookies.append({
+ "name": name,
+ "value": val,
+ "domain": ".xiaohongshu.com",
+ "path": "/",
+ "expires": -1,
+ "size": len(name) + len(val),
+ "httpOnly": False,
+ "secure": False,
+ "session": True,
+ "sameSite": "Lax",
+ })
+ if cookies:
+ cookies_json = json.dumps(cookies)
+ print(f" Parsed {len(cookies)} cookies from Header String format")
+ else:
+ print("[X] Could not parse any cookies from input")
+ return
+
+ if not cookies_json:
+ print("[X] Could not parse cookies. Accepted formats:")
+ print(' 1. JSON array: \'[{"name":"x","value":"y","domain":".xiaohongshu.com",...}]\'')
+ print(' 2. Header String: "key1=val1; key2=val2; ..."')
+ return
+
+ # Find the container
+ docker = shutil.which("docker")
+ if not docker:
+ # No Docker - write to a local file for manual import
+ cookie_path = os.path.expanduser("~/.agent-reach/xhs-cookies.json")
+ with open(cookie_path, "w") as f:
+ f.write(cookies_json)
+ os.chmod(cookie_path, 0o600)
+ print(f" Cookies saved to {cookie_path}")
+ print(" Docker not found. Copy manually:")
+ print(f" docker cp {cookie_path} xiaohongshu-mcp:/app/data/cookies.json")
+ return
+
+ # Check if xiaohongshu-mcp container is running
+ try:
+ result = subprocess.run(
+ [docker, "ps", "--filter", "name=xiaohongshu-mcp", "--format", "{{.Names}}"],
+ capture_output=True, encoding="utf-8", timeout=5,
+ )
+ container_name = result.stdout.strip()
+ if not container_name:
+ print("[X] xiaohongshu-mcp container is not running.")
+ print(" Start it first:")
+ print(" docker run -d --name xiaohongshu-mcp -p 18060:18060 xpzouying/xiaohongshu-mcp")
+ return
+ except Exception as e:
+ print(f"[X] Could not check Docker: {e}")
+ return
+
+ # Find the cookies path inside the container
+ try:
+ result = subprocess.run(
+ [docker, "exec", container_name, "printenv", "COOKIES_PATH"],
+ capture_output=True, encoding="utf-8", timeout=5,
+ )
+ cookie_path_in_container = result.stdout.strip()
+ if not cookie_path_in_container:
+ cookie_path_in_container = "cookies.json" # fallback to workdir
+ except Exception:
+ cookie_path_in_container = "cookies.json"
+
+ # Write cookies into the container
+ try:
+ # Write to temp file then docker cp
+ import tempfile
+ with tempfile.NamedTemporaryFile(mode="w", suffix=".json", delete=False) as f:
+ f.write(cookies_json)
+ tmp_path = f.name
+
+ result = subprocess.run(
+ [docker, "cp", tmp_path, f"{container_name}:{cookie_path_in_container}"],
+ capture_output=True, encoding="utf-8", timeout=10,
+ )
+ os.unlink(tmp_path)
+
+ if result.returncode != 0:
+ print(f"[X] Failed to copy cookies: {result.stderr}")
+ return
+
+ print(f"✅ Cookies written to {container_name}:{cookie_path_in_container}")
+ except Exception as e:
+ print(f"[X] Failed to write cookies: {e}")
+ return
+
+ # Verify login status via mcporter
+ mcporter = shutil.which("mcporter")
+ if mcporter:
+ print(" Verifying login status...", end=" ")
+ try:
+ result = subprocess.run(
+ [mcporter, "call", "xiaohongshu.check_login_status()"],
+ capture_output=True, encoding="utf-8", errors="replace", timeout=15,
+ )
+ if "已登录" in result.stdout or "logged" in result.stdout.lower():
+ print("✅ Login verified!")
+ else:
+ print("[!] Login check returned unexpected result:")
+ print(f" {result.stdout.strip()[:200]}")
+ print(" Cookies were written but login might not be valid. Try fresh cookies.")
+ except Exception as e:
+ print(f"[!] Could not verify: {e}")
+ else:
+ print(" (mcporter not found, skipping verification)")
+
+
def _cmd_uninstall(args):
"""Remove all Agent Reach config, tokens, and skill files."""
import shutil
diff --git a/docs/install.md b/docs/install.md
index db74a443..5e46680e 100644
--- a/docs/install.md
+++ b/docs/install.md
@@ -148,9 +148,17 @@ mcporter config add xiaohongshu http://localhost:18060/mcp
>
> **登录方式(优先用 Cookie-Editor,最简单):**
> 1. 用户在自己的浏览器登录小红书 (xiaohongshu.com)
-> 2. 用 [Cookie-Editor](https://chromewebstore.google.com/detail/cookie-editor/hlkenndednhfkekhgcdicdfddnkalmdm) 插件导出 Cookie(Header String 格式)
+> 2. 用 [Cookie-Editor](https://chromewebstore.google.com/detail/cookie-editor/hlkenndednhfkekhgcdicdfddnkalmdm) 插件导出 Cookie(JSON 或 Header String 格式均可)
> 3. 把 Cookie 字符串发给 Agent
-> 4. Agent 将 Cookie 写入 MCP 服务的 cookie 文件完成登录
+> 4. Agent 运行命令完成登录:
+>
+> ```bash
+> # JSON 格式(Cookie-Editor → Export → JSON)
+> agent-reach configure xhs-cookies '[{"name":"web_session","value":"xxx","domain":".xiaohongshu.com",...}]'
+>
+> # 或 Header String 格式(Cookie-Editor → Export → Header String)
+> agent-reach configure xhs-cookies "key1=val1; key2=val2; ..."
+> ```
>
> **备选:** 本地电脑如果有浏览器,也可以打开 http://localhost:18060 扫码登录。