Files
Agent-Reach/docs/troubleshooting.md
T
fernando_jacob d793afaba6 fix(xueqiu): fix 400 errors by using browser cookies and correct headers
The Xueqiu stock API requires a login session token (xq_a_token) that
is generated by Xueqiu's frontend JavaScript and cannot be obtained by
simply visiting the homepage. This caused persistent HTTP 400 (error
code 400016) for all users.

Changes:
- _ensure_cookies(): add three-level priority — config file (saved by
  --from-browser) → live Chrome cookies via browser_cookie3 → homepage
  fallback. The homepage-only approach only ever got acw_tc (anti-DDoS
  token), never xq_a_token.
- _get_json(): switch User-Agent from "agent-reach/1.0" to a real Chrome
  UA, and add Referer: https://xueqiu.com/ to all API requests.
- get_hot_posts(): replace the defunct /statuses/hot/listV3.json endpoint
  (returns empty body) with the v4 public timeline endpoint; correctly
  parse item.data as a JSON string to extract author, text, and likes.
- cookie_extract.py: add Xueqiu to PLATFORM_SPECS and configure_from_browser
  so that `agent-reach configure --from-browser chrome` now also saves
  Xueqiu cookies (only when xq_a_token is present).
- check(): improve error message to direct users to --from-browser instead
  of suggesting a proxy.
- Fix urllib.parse.quote usage (was using urllib.request.quote).
- Update tier and backends description to reflect cookie requirement.
- Add 2 new tests: cookie loading from config, Referer/UA header verification.
- Update docs: README, install guide, troubleshooting, SKILL.md, CHANGELOG.
2026-03-27 11:55:14 +08:00

1.5 KiB

常见问题排查

雪球 / Xueqiu: API 返回 400

症状: agent-reach doctor 显示雪球 ⚠️,报 HTTP Error 400

原因: 雪球 API 需要登录 Cookie,无法通过匿名访问获取。

解决方案: 在 Chrome 里登录 xueqiu.com,然后运行:

agent-reach configure --from-browser chrome

再次运行 agent-reach doctor 确认恢复 。Cookie 过期后重新运行即可。


Twitter/X: bird CLI 连接失败

症状: bird search 或其他命令返回错误

原因: bird CLI 需要 AUTH_TOKEN 和 CT0 环境变量才能访问 Twitter API。如果你的网络环境需要代理才能访问 x.com,需要配置代理。

解决方案:

方案 1:设置环境变量代理

export HTTP_PROXY="http://user:pass@host:port"
export HTTPS_PROXY="http://user:pass@host:port"
bird search "test" -n 1

方案 2:使用全局代理工具

让代理工具接管所有网络流量,这样 bird 的请求也会走代理:

# macOS — ClashX / Surge 开启"增强模式"
# Linux — proxychains 或 tun2socks
proxychains bird search "test" -n 1

方案 3:不用 bird,用 Exa 搜索替代

bird 不可用时,可以直接用 Exa 搜索 Twitter 内容:

mcporter call 'exa.web_search_exa(query: "site:x.com 搜索词", numResults: 5)'

方案 4:检查认证

bird check

如果返回 "Missing credentials",需要设置 AUTH_TOKEN 和 CT0 环境变量。