fernando_jacob
d793afaba6
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.
60 lines
1.5 KiB
Markdown
60 lines
1.5 KiB
Markdown
# 常见问题排查
|
|
|
|
## 雪球 / Xueqiu: API 返回 400
|
|
|
|
**症状：** `agent-reach doctor` 显示雪球 ⚠️，报 `HTTP Error 400`
|
|
|
|
**原因：** 雪球 API 需要登录 Cookie，无法通过匿名访问获取。
|
|
|
|
**解决方案：** 在 Chrome 里登录 xueqiu.com，然后运行：
|
|
|
|
```bash
|
|
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：设置环境变量代理
|
|
|
|
```bash
|
|
export HTTP_PROXY="http://user:pass@host:port"
|
|
export HTTPS_PROXY="http://user:pass@host:port"
|
|
bird search "test" -n 1
|
|
```
|
|
|
|
### 方案 2：使用全局代理工具
|
|
|
|
让代理工具接管所有网络流量，这样 bird 的请求也会走代理：
|
|
|
|
```bash
|
|
# macOS — ClashX / Surge 开启"增强模式"
|
|
# Linux — proxychains 或 tun2socks
|
|
proxychains bird search "test" -n 1
|
|
```
|
|
|
|
### 方案 3：不用 bird，用 Exa 搜索替代
|
|
|
|
bird 不可用时，可以直接用 Exa 搜索 Twitter 内容：
|
|
|
|
```bash
|
|
mcporter call 'exa.web_search_exa(query: "site:x.com 搜索词", numResults: 5)'
|
|
```
|
|
|
|
### 方案 4：检查认证
|
|
|
|
```bash
|
|
bird check
|
|
```
|
|
|
|
> 如果返回 "Missing credentials"，需要设置 AUTH_TOKEN 和 CT0 环境变量。
|