go-threads-api

这是 Threads Android 私有 API 的 Go SDK、gRPC 服务与 Python 异步客户端。 如果你要调用接口，请从任务开始，而不是先读 Proto。

面向 API 使用者

1. 快速开始：连接 gRPC 服务并读取当前账号。
2. 模块与任务指南：按登录、资料、发帖和采集任务查看接口调用顺序。
3. 接口与参数参考：逐接口核对参数类型、动态参数来源、响应字段和错误。
4. 接口验证状态：确认接口当前可用、实验中或尚未实现。

常见任务

• 校验 token：client.auth.get_current_user(edit=False)
• 编辑资料：先读取 get_current_user(edit=True)，再完整调用 client.profile.edit_profile(...)
• 发布文本帖：直接调用 client.posts.create_text_post(...)
• 发布单图帖：先 client.posts.upload_image(...)，再把返回的 upload_id 传给 client.posts.create_image_post(...)
• 发布视频帖：当前不可用，尚无视频上传和视频创建 RPC
• 采集主页帖子：循环调用 client.profile.list_profile_threads(...)，把上一页 next_cursor 传入下一页 max_id

面向 AI 与自动化代理

AI 应先读取 llms.txt 发现入口。Python 代码生成优先读取 python/llms-full.txt，其中包含工作流、参数来源、步骤间字段传递和完整方法参考。 结构化工具可读取 capabilities.json。

人类文档与 AI 文档共享 Proto、Python 门面和接口语义元数据，不分别维护接口事实。