如何用treg接入Instagram OAuth？直接登录与Facebook Page工具配置指南

如何用treg接入Instagram OAuth直接登录与Facebook Page工具配置指南【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/treg如果你想在 AI Agent 中安全地调用自己的 Instagram 账号数据tregOpenRouter for agent tools提供了完整的 Instagram OAuth 接入方案。treg 是一个面向 Agent 的工具注册中心与 API 代理本文带你走通两条授权路线Instagram 直接登录instagram-login与Facebook Page 工具facebook-page从账号准备、Dashboard 一键授权到 CLI 命令行连接全部讲清楚。为什么用 treg 连接 Instagram而不是自己申请 API Key自己对接 Instagram Graph API 意味着你要创建 Meta App、申请 Advanced Access、管理 access token 的过期与刷新、处理限流……而 treg 把这些全部托管了凭据永不离开服务器OAuth token 加密存储在服务端treg 自动刷新你的 Agent 拿到的只是调用结果32 个已验证的 Instagram 端点资料、帖子、评论、Insights 数据、私信、发帖、标签搜索等按端点 ID 直接调用私有数据爬虫拿不到比如你账号的真实触达reach、收藏数saves、主页浏览量只有官方 OAuth 授权才能读到团队共享连接一次团队里所有成员和 Agent 都能调用。完整的端点定义见 src/treg/catalog/instagram.yaml 与 src/treg/catalog/instagram.extended.yaml每个端点都声明了路径、参数与权限要求。两条授权路线怎么选直接登录 vs Facebook Page 工具treg 把instagram设计为一个目录供应商下的两种独立授权grant二选一或同时拥有对比项 Instagram 直接登录instagram-login Facebook Page 工具facebook-page走的接口Instagram 自己的域名graph.instagram.comgraph.facebook.com账号要求Instagram企业版Business或创作者Creator账号即可企业版账号必须已关联一个 Facebook 主页支持的端点21 个共享端点21 个共享端点 11 个 Page 专属端点独占能力无需 Facebook 主页个人创作者友好标签搜索hashtag search、商业发现business discovery、提及查询、产品申诉等私信权限manage能力直接包含需要额外勾选page-messages能力 简单判断没有 Facebook 主页→ 走直接登录有主页且想做标签/竞品类数据→ 走 Facebook Page 工具。两者互不替代——直接登录的授权无法调用 Page 专属端点。授权契约的完整说明包括权限映射与端点矩阵在 docs/context/architecture/instagram-oauth.md。准备工作Meta 侧的 4 项检查连接之前请确认以下条件一次配置长期有效Instagram 账号已转为企业版或创作者账号Settings → Account type否则授权回调后无法识别账号走 Facebook Page 路线的话在 Instagram 后台把企业账号与你的 Facebook 主页完成关联回调地址已登记在 Meta App Dashboard 中把 treg 的生产回调地址oauth/callback路径加入 Instagram 的 Business login 设置本地调试时临时替换为你自己的隧道地址应用密钥已配置Instagram 专用的 App ID / Secret 分别写入服务端环境变量TREG_INSTAGRAM_CLIENT_ID与TREG_INSTAGRAM_CLIENT_SECRET切勿写进代码仓库Page 路线复用的 Meta 应用凭据则为TREG_META_CLIENT_ID/TREG_META_CLIENT_SECRET。⚠️ 如果让用户连接应用所有者不管理的账号还需要在 Meta 侧申请相关权限的 Advanced Access。官方要求的权限清单instagram_business_basic、instagram_business_manage_insights、instagram_business_content_publish等同样记录在架构文档 docs/context/architecture/instagram-oauth.md。三步完成连接Dashboard 浏览器授权推荐新手登录 treg 后台后整个 OAuth 流程在浏览器内完成无需任何本地配置进入供应商连接页在 Marketplace / Connections 视图找到 Instagram点击Add account添加账号选择授权方式页面会展示两个单选项——Instagram 直接登录 或 Facebook Page 工具。选择后会出现能力选择器直接登录可选读取 / 发帖 / 管理managePage 路线可选核心工具page-tools或加上私信page-messages浏览器授权跳转 Meta 同意页 → 登录后选择要授权的账号 → 自动回到 treg。回调完成后treg 会把短期 token 换成可自动刷新的长期 token并把你授权的专业账号存为所选资源直接生成可用工具。连接后建议做一次健康检查treg health --run会重新校验 OAuth 凭证状态与到期时间。如果账号识别失败连接记录会显示healthsetup_required这通常意味着账号还不是企业版/创作者账号——切换账号类型后重新连接即可此时不会创建任何工具。命令行连接treg connections connect 一条命令习惯终端的开发者可以用 CLI 完成同样的事命令详见 docs/context/interface/cli.md 与 USAGE.md# 连接 Instagram浏览器授权 → treg 自动捕获 token treg connections connect --provider instagram # Page 路线核心工具 / 私信能力 treg connections connect --provider instagram --capability page-tools treg connections connect --provider instagram --capability page-messages授权开始前CLI 会先向服务端取回当前生效的连接指引POST /oauth/start返回的connect_guidance并打印出来让你看清本次授权将请求哪些权限。同一时期--authorization-method与能力默认值由服务端的审核状态统一控制CLI 本身不包含任何 Instagram 专属逻辑。连接完成后可用treg connections ls查看已连接账号与健康状态treg connections resources id查看授权背后发现的账号。调用 Instagram 数据treg call 实战连接成功后像调用任何目录端点一样使用treg catalog search instagram profile # 按能力搜索端点 treg catalog get instagram.instagram.user.profile # 查看参数与价格 treg call instagram.instagram.user.profile \ --query ig_user_id17841400000000000 \ --query fieldsid,username,followers_count,media_count几个高频端点示例端点 ID能做什么instagram.instagram.user.profile读取自己账号的资料、粉丝数instagram.instagram.user.posts列出帖子、点赞与评论数instagram.instagram.account.insights账号触达、互动、受众指标day / week / days_28instagram.instagram.media.insights单条帖子的触达、收藏、分享数据instagram.instagram.message.send回复客户主动发起的私信受 Meta 消息窗口政策约束双方法端点如何选授权当一个端点两种路线都支持时可用--authorization-method instagram-login或facebook-page显式指定API 调用则用X-Treg-Authorization-Method头该头只被 treg 消费、不会转发给上游。省略时按确定规则回退只有一个已连接授权就用它否则默认 Instagram 直接登录。遇到 HTTP 428 别慌它表示该端点需要一种你还没连的授权返回体里带有稳定的字段——缺少的授权、所需能力、权限列表、修复用的 CLI 命令和 Dashboard 操作入口照着执行即可而不是一个模糊的报错。常见问题FAQQ1连接成功但没有生成工具账号不是 Business/Creator 类型时连接会保留但标记为setup_required。转换账号类型后重新连接即可。Q2直接登录能调用 hashtag 搜索吗不能。标签搜索、商业发现等 11 个端点是Page 专属需要facebook-page授权且账号已关联主页。这正是两个授权相互独立的设计。Q3发消息会不会变成群发工具不会。instagram.instagram.message.send是回复型接口对方必须先联系你且受 Meta 的消息窗口与政策限制。发帖同样有配额——每个账号 24 小时最多 100 条 API 发布的帖子轮播算一条可先调用content_publishing_limit查询剩余额度。Q4旧的 Facebook Login 授权还能用吗可以。数据库迁移 0010 会把历史 Instagram 授权标记为facebook-page滚动升级无需重新连接。参考资料架构契约与已验证端点矩阵docs/context/architecture/instagram-oauth.md端点目录定义src/treg/catalog/instagram.yaml、src/treg/catalog/instagram.extended.yamlCLI 命令参考docs/context/interface/cli.md、USAGE.md连接前端状态实现frontend/src/state/connections.js架构测试tests/test_instagram_oauth_architecture.py按上面的步骤走一遍大约 5 分钟就能让 Agent 安全地读到你 Instagram 账号的私有数据——token 管理、刷新、权限缺口提示全部交给 treg 处理。【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/treg创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考