mcpField
I
instagram

instagram

github.com/sickn33营销与增长48.8k71 次安装今天更新
代码仓库

关于 instagram

这是一个社区维护的 Python 工具包，用于读取 Instagram 资料和媒体、在本地保存分析数据并导出结果。它面向明确授权的账号工作流；发布和计划执行功能已禁用。

主要功能

  1. 01读取 Instagram 资料与媒体
  2. 02SQLite 本地分析与存储
  3. 03导出数据为 CSV
  4. 04查看发布预览
  5. 05读取媒体洞察指标

适用场景

  1. 01检查已授权账号的资料和媒体
  2. 02分析帖子表现并导出 CSV
  3. 03查看媒体洞察数据
  4. 04审阅发布草稿预览

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/sickn33/agentic-awesome-skills --skill instagram

安装后在 Claude Code 中输入/instagram确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
account_types.md
publishing_guide.md
rate_limits.md
setup_walkthrough.md
permissions.md
graph_api.md
schema.md
scripts/
analyze.py
account_setup.py
comments.py
export.py
api_client.py
governance.py
auth.py
db.py
csv_utils.py
hashtags.py
config.py
insights.py
messages.py
media.py
profile.py
requirements.txt
run_all.py
serve_api.py
templates.py
publish.py
schedule.py
static/
dashboard.html

详细介绍

Instagram Graph API 工具包

概述

社区维护的 Python 工具包，支持读取个人资料和媒体、本地 SQLite 分析、导出和发布预览。捆绑的集成使用 Facebook Login、graph.facebook.com 和已关联的 Facebook Page；不实现单独的 Instagram Login 流程。API v21.0、指标、权限、配额和媒体规格均为历史示例：使用前，请根据所选账户和 API 版本查阅 Meta 当前文档。

适用场景

用于明确请求的 Instagram 账户工作流，或检查这些脚本。对于受支持的任务，优先使用可用的服务连接器。仅提及 Instagram 并不代表授权更改账户、OAuth、上传、发布或发送消息。

工作流

  1. 阅读相关脚本和参考资料。使用隔离环境，并在安装 scripts/requirements.txt 前检查依赖项。以下命令均在此技能目录中运行。
  2. 如需连接已获授权的账户，请配置你自己的 Meta 应用和确切的重定向 URI，然后运行 python3 scripts/auth.py --setup。这会打开浏览器并请求列出的 OAuth 作用域。本地数据库以明文存储令牌和应用密钥，并通过本地权限保护；数据库位于技能源代码之外（AAS_INSTAGRAM_DATA_DIR 或 config.py 中的每用户应用数据目录）。请勿提交或分享此目录、其备份或导出文件。
  3. 检查 python3 scripts/auth.py --status，然后仅请求所需的读取操作。读取命令可能会尝试续期令牌并保存获取的数据。令牌续期可能失败或需要重新授权；不能保证其可在无人值守时完成。--revoke 仅停用本地账户；请另行通过 Meta 撤销服务提供商的访问权限。
  4. 检查输出和部分失败情况。同步时每种资源只读取一页，而非整个账户。收集评论或对话前，请检查当前权限、账户所有权和保留政策。

示例

python3 scripts/profile.py --view
python3 scripts/media.py --list --limit 10
python3 scripts/run_all.py --dry-run
python3 scripts/insights.py --media --media-id MEDIA_ID --metrics reach
python3 scripts/analyze.py --top-posts --limit 10
python3 scripts/export.py --type posts --format csv --output /absolute/private/export-directory
python3 scripts/serve_api.py --host 127.0.0.1

仪表板未经身份验证，必须仅限环回访问（包括通过 ASGI 工具启动时）；请勿将其代理到网络或向网络公开。某些统计数据会读取所有已存储的账户。Chart.js 从第三方 CDN 加载。导出文件可能包含个人数据；请妥善保密。

发布和消息边界

publish.py 会返回预览／确认请求。现有 CLI 确认 ID 不会持久保存，也不会绑定到不可变的载荷／账户，因此已禁用确认后的执行。视频／轮播执行以及评论／DM 确认处理仍未完成。在实现持久审批、原子化工作进程认领和不确定结果协调之前，schedule.py --process 处于禁用状态。schedule.py 不接受 --at，也不会创建定时帖子。请勿绕过这些保护措施，也不要更改确认类别来执行预览。

草稿不再上传本地媒体。公开 Imgur 上传需要你自己的 IMGUR_CLIENT_ID、明确授权将该文件分享给 Imgur，以及 AAS_INSTAGRAM_ALLOW_IMGUR_UPLOAD=1；此选项仅用于经过审查的集成，不得用于绕过已禁用的发布功能。本地视频不受图片上传／转换路径支持。实现集成时，优先使用已获授权的公开 HTTPS 媒体 URL。公开 URL 可能会在 Instagram 发布内容前泄露内容。

Graph 写入操作仅尝试一次：超时可能意味着操作已成功。重试前，请与 Meta 核实。即使本地速率计数器也只是估算值，并非服务提供商的强制限制：它们无法完全计入失败调用、其他客户端或并发工作进程；DM 和唯一主题标签限制也尚未完整实现。请遵循服务提供商的实时错误／响应头。

参考资料

  • references/graph_api.md：历史端点和请求格式
  • references/permissions.md：Facebook Login 权限范围示例
  • references/account_types.md：账户设置注意事项
  • references/publishing_guide.md：历史媒体示例和限制
  • references/rate_limits.md：本地估算值和提供方限制
  • references/setup_walkthrough.md：历史 Meta 设置界面
  • references/schema.md：本地数据架构；以 scripts/db.py 为准

限制

不保证与实时账户/API 的兼容性，也不保证应用审核通过。洞察快照是重复的生命周期测量结果，并非可累加的事件；历史指标可能已停用，必须检查周期和指标是否受支持。最佳发布时间结果描述的是以 UTC 记录的观测样本，并非因果意义上的最佳发布时间。Webhook 处理程序返回 501，且不接收任何事件。没有持久化调度器、多租户授权、加密密钥保险库或可用于生产环境的确认服务。

评论

支持 Markdown