go-threads-api

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

可以把 API 文档网址直接交给 AI

具备网页读取能力的 AI 可以直接访问公开的 https://threads-api.es007.com/llms.txt。 测试版使用 https://threads-api.es007.com/test/latest/llms.txt。 具体文件选择、固定版本地址和提示词见 AI 直接接入。

面向 API 使用者

1. 快速开始：连接 gRPC 服务并读取当前账号。
2. Python SDK 下载：下载当前文档版本对应的 wheel、sdist 或可复制目录包。
3. AI 直接接入：把公开 llms.txt URL 直接交给 AI 或自动化代理。
4. 模块与任务指南：按登录、资料、发帖和采集任务查看接口调用顺序。
5. 接口与参数参考：逐接口核对参数类型、动态参数来源、响应字段和错误。
6. 接口验证状态：确认接口当前可用、实验中或尚未实现。

Python SDK 与 Go server 使用同一 Tag、同一 X.Y.Z 版本发布。使用者可以从当前版本的 Python SDK 下载页获取 wheel、sdist，或下载复制包后直接复制完整 threads_sdk/ 目录。客户端启动时通过 ThreadsClient(target="服务器地址") 设置 Go gRPC server 地址。

常见任务

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

面向 AI 与自动化代理

具备网页读取能力的 AI 应先访问公开的 https://threads-api.es007.com/llms.txt。 Python 代码生成优先读取 python/llms-full.txt，其中包含工作流、参数来源、步骤间字段传递和完整方法参考。 结构化工具可读取 capabilities.json。

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