同行 X 账号这次有什么值得跟进?怎么只整理新看到的动态?
要跟进一个公开 X 账号,先用 twitter.web.fetch_user_post_tweet 取账号时间线的第一页,保存为基线。之后每轮重新取第一页,运行 watch_account.py 按帖子 ID 和已保存的状态比对,找出本地没见过的帖子。发布时间和发现时间分开记录,再挑出产品更新、活动或值得跟进的讨论。
例如这轮第一次看到一条上周发布的置顶帖,就把这条帖子列为「本轮发现的旧帖」。真正在这次新发布的版本通知,保留原帖和生效日期,交给同事跟进。
第一次先建基线,别把整页当新消息
确认 handle 对应的是你要研究的公开账号,保存这次的首页响应和实际观察时间。首次导出的 new-posts.csv 只有表头,因为第一轮是在建立起点,不代表账号没有内容。之后每轮都从上次已验收的状态继续比较,历次输出全部保留,不覆盖证据。
账号改名、同名被重用或身份无法确认时,先重新核对账号身份并重建基线;watch_account.py 不会自行验证账号所有权的连续性。只是重新整理数据时,直接在本地比较已保存的响应,不要再买一次首页查询。
新出现的条目,哪些值得团队看?
下表是常见变化的审核方法:
是否值得关注由人判断。互动更高不等于商业机会,单个公开账号的活动也不能代表整个行业在增长。
交一份能接着研究的变化摘要
保留账号、前后两次观察时间、本轮新观察到的 ID、原帖来源、具体变化、与业务的关系和下一步核查。new-posts.csv 是候选清单;编辑理由、负责人和完成状态写在另存的工作表里,watch_account.py 不会填写这些列,也不分派任务。
先看本轮 coverage.json 里的条数和遗漏边界,抽查原始证据后,再接受本轮新的 state.json。每天只看首页,可能漏掉两次观察之间发布的帖子;补历史需要另外批准范围,不能把历史页当成下一次日常检查点。把“只看首页”这个限制写进摘要,避免“没看到”被理解成“没发生”。
例如观察 20 个账号时,每个账号的基线和最后成功时间分开保存。某个账号当天读取失败时,摘要照常交付其他账号的变化,把失败的账号单独标记待补。这个账号恢复读取后,用该账号最后一份有效状态比较。
按需要安排观察,先算账号数和轮次
需要新的观察时才发起账号请求,费用按“账号数 × 轮次 × 动作当前价格”估算;翻页、重试、模型分析和通知另算。不要因为某一页条数少就自动提高频率。先确认要解决的研究问题和可以接受的遗漏,再选定批准的观察节奏。
下面第 1–6 步是完整的取数和本地比较代码。watch_account.py 不会自行购买查询;是否采集新页、是否对外发送摘要,都由你单独决定。
1. 明确账号与费用上限
20 个账号每天各查一页,连续 30 天是 600 次列表请求。加页和模型分析另外计算。见 BeatAPI 价格页。
screen_name 填账号名,不带 @,也不填完整主页链接。twitter.web.fetch_user_post_tweet 另外支持整数 rest_id,两者同时填写时优先使用 rest_id,所以本流程只发送 screen_name。twitter.web.fetch_user_post_tweet 没有 tab 参数,帖子、回复、仅媒体和关键词提及不是同一个列表。
2. 保存一次首页观察
把实际目标账号填入 request.json:
批准这次查询后,把原始响应和响应头保存到新目录:
记录真实的 HTTP 状态和带时区的采集时间。请求出错时,上一轮的监测状态保持不变;保留失败的原文件,不自动重试。要用完整的直接响应,不能把 AI 预览的前几项当成整页。
在响应目录旁保存 observation.json。下面只演示格式,所有值都替换成实际请求和观察:
3. 先建基线,再比较下一次已存首页
把下面的代码保存为 watch_account.py,分两步运行:
- 第一轮运行
python3 watch_account.py observation.json - x-baseline。横杠表示没有历史状态:本页返回的所有帖子都记作基线,new-posts.csv只有表头。 - 之后每轮运行
python3 watch_account.py observation-next.json x-baseline/state.json x-next。下一轮传入最新一份已验收的state.json路径,不要覆盖旧的输出目录。
watch_account.py 只在本地处理。创建输出前,脚本检查账号范围、时间先后、请求重放、字符串 ID、报告的计数和响应结构。同一 ID 的点赞数变化不算新帖子。当前页每个不同的 ID 都写入 observed-posts.csv;同一页里重复的 ID 只保留第一行,raw-response.json 保留全部原始观察。
4. 正确解释交付文件
new-posts.csv:相对历史状态新出现的编号,不等于“昨天之后发布”。平台重新展示的旧帖也可能第一次出现。observed-posts.csv:当前页的 baseline/seen_before/newly_observed 分类,文案、报告的发布时间、互动数与查询来源;缺值留空,0保留为0。profile.json、pinned.json:分别保存data.user和data.pinned的原对象。已观测合同里,timeline 的作者姓名和screen_name为空,脚本不会用请求的账号名填作者列。转推涉及其他人的原作,has_retweeted_object标明转推的原作对象存在,完整内容仍在原始 JSON 里。coverage.json:当前页的条数、原文件哈希和续页游标。以前见过、这一页没出现的 ID 不会被标为已删除。哈希用于发现已保存原文件的变化,不能证明账号身份,也不是防篡改的完整历史。state.json:这个账号名历次见过的帖子 ID 和已接受的请求号。账号改名或名称被重新使用时,重新核对并建立新基线;watch_account.py不会自行验证账号所有权的连续性。
置顶帖不会因为置顶就进入新增清单;同一个 ID 也出现在 timeline 里时,按正常去重处理。作者字段、浏览量或正文缺失时,不填猜测值。
5. 记录遗漏与继续分页的边界
每次新的监测都从不带 cursor 的账号首页开始,不要把昨天的游标当成今天的起点。也不能遇到第一个旧 ID 就停止处理本页:置顶或混合排序会让旧帖子排在新帖子前面。
活跃账号每天只取一页,可能会漏帖。watch_account.py 保存 next_cursor,并在本页非空时生成 backfill-request.json。backfill-request.json 是一个待批准预算的历史下一页请求,脚本不会自动发送。回填的历史结果另存为一组采集;watch_account.py 拒绝带 cursor 的请求,防止历史页悄悄变成下一次日常检查点。不能漏掉重要动态时,提高已批准的查询频率,或另建历史回填流程。没有游标或返回空页,都不能证明已覆盖全部历史。
6. 交付可行动的摘要
- 人工核对
new-posts.csv里的相关变化,给每条补上值得关注的理由。 - 用保留的 ID 组成链接
https://x.com/i/status/<tweet_id>。 - 摘要聚焦公开的商业活动,不记录个人行踪,也不推测私密属性。
- 在摘要里注明账号、查询时间、不同帖子数和抽样范围。
watch_account.py 不会把摘要发给团队,也不开启周期性付费查询;这两项需要另行配置。
接受新的 state.json 前,抽两行与 raw-response.json 对照,再看 coverage.json。修改展示或重新导出已存文件不增加查询费用。依据:twitter.web.fetch_user_post_tweet 的已发布输出结构;示例中的账号占位符请替换为实际目标公开账号。

