Instagram MCP Server

Instagram MCP Server

site icon
2025.01.09 0
TypeScriptInstagram 数据获取媒体下载SEO 生成内容生成
Instagram MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器,用于通过 Chrome 的现有登录会话获取 Instagram 帖子。它具有模块化架构、类型安全的 TypeScript 实现、改进的错误处理和日志记录、通过环境变量配置、JSON-RPC 2.0 兼容的通信、自动媒体下载和元数据生成以及 SEO 友好的描述生成等功能。
View on GitHub

Overview

基本能力

产品定位

Instagram MCP Server 是一个专门用于获取 Instagram 帖子的服务器,通过 Chrome 的现有登录会话实现高效的数据抓取和处理。

核心功能

  • 模块化架构,关注点分离
  • 使用 TypeScript 实现类型安全
  • 改进的错误处理和日志记录
  • 通过环境变量配置
  • JSON-RPC 2.0 兼容的通信
  • 自动媒体下载和元数据生成
  • SEO 友好的描述生成

适用场景

  • 需要批量获取 Instagram 帖子的场景
  • 需要自动下载 Instagram 媒体文件的场景
  • 需要生成 SEO 友好描述的场景

工具列表

  • get_instagram_posts: 从 Instagram 个人资料获取最近的帖子。
  • 参数:
    • username (必需): Instagram 用户名
    • limit (可选): 要获取的帖子数量 (1-50) 或 "all"
    • saveDir (可选): 保存媒体文件和元数据的目录
    • delayBetweenPosts (可选): 处理帖子之间的等待时间(毫秒)

常见问题解答

  • 错误代码:
  • INVALID_REQUEST: 无效的请求格式或参数
  • INVALID_PARAMS: 缺少或无效的参数
  • METHOD_NOT_FOUND: 未知的方法或工具
  • INTERNAL_ERROR: 服务器端错误

使用教程

使用依赖

  1. 确保已安装 Node.js 和 npm。

安装教程

  1. 安装依赖: bash npm install
  2. 构建服务器: bash npm run build
  3. 运行服务器: bash CHROME_USER_DATA_DIR=/path/to/chrome/profile npm start

调试方式

  1. 开发模式下启动: bash npm run dev
  2. 运行 linter: bash npm run lint

许可证

该项目遵循 MIT 开源许可条款。