Instagram命令行界面
终端优先的Instagram分析、下载和MCP工具由HikerAPI、OpenRouter和FastMCP提供支持。
___ _ _ ____ _____ _ ____ ____ _ __ __ ____ _ ___
|_ _| \ | / ___|_ _|/ \ / ___| _ \ / \ | \/ | / ___| | |_ _|
| || \| \___ \ | | / _ \| | _| |_) | / _ \ | |\/| | | | | | | |
| || |\ |___) || |/ ___ \ |_| | _ 检查->排名->导出
- 打开个人资料->分析出版物->下载内容
- 获取卷轴->查看评论或喜欢者->导出结果
- 通过本地MCP服务器为Claude和其他MCP客户端公开相同的功能层
## 需求
- macOS或Linux
- python `3.10+`
- `HIKERAPI_KEY` 或 `HIKERAPI_TOKEN`
- `OPENROUTER_API_KEY` 对于交互式CLI代理
## 安装
cd /path/to/instagram-cli ./install.sh
这将安装两个命令：
- `instagram` 用于交互式CLI
- `instagram-mcp` 对于本地MCP服务器
在另一个项目中作为Python依赖项安装：
pip install git+https://github.com/lupikovoleg/instagram-cli.git
## 首次运行
CLI使用自己的 `.env` 文件。
- 默认路径： `/path/to/instagram-cli/.env`
- 覆盖路径： `INSTAGRAM_CLI_ENV_FILE=/path/to/custom.env`
如果缺少所需的密钥，CLI引导程序会请求它们并写入本地 `.env`.
## 快速开始
启动CLI：
典型命令：
instagram> profile lupikovoleg instagram> search portugal creators instagram> search reels about dubai attack instagram> publications lupikovoleg 10 30 all instagram> comments https://www.instagram.com/reel/XXXXXXXXXXX/ 100 instagram> download media https://www.instagram.com/reel/XXXXXXXXXXX/ instagram> export csv latest-results instagram> how many followers does @lupikovoleg have? instagram> find today's reels about an attack on Dubai instagram> find 100 reels about Dubai real estate
启动MCP服务器：
instagram-mcp
将其用作Python库：
from instagram_cli import InstagramClient
client = InstagramClient.from_env(env_file="/path/to/instagram-cli/.env") profile = client.get_profile_stats(target="lupikovoleg")
自定义代理示例：
python /path/to/instagram-cli/examples/custom_agent.py \ --env-file /path/to/instagram-cli/.env \ "How many followers does @lupikovoleg have?"
## MCP设置
克劳德代码：
claude mcp add instagram-cli -- /path/to/instagram-cli/.venv/bin/instagram-mcp
macOS上的Claude Desktop配置文件：
~/Library/Application Support/Claude/claude_desktop_config.json
例子：
{ "mcpServers": { "instagram-cli": { "command": "/path/to/instagram-cli/.venv/bin/instagram-mcp", "args": [], "env": { "INSTAGRAM_CLI_ENV_FILE": "/path/to/instagram-cli/.env" } } } }
## 文档
- 内部Python集成记录在 [Python库指南](docs/library.md).对于你自己的Python产品，更喜欢直接嵌入 `InstagramClient` 通过MCP。
- [CLI指南](docs/cli.md)
- [Python库指南](docs/library.md)
- [MCP指南](docs/mcp.md)
- [建筑](docs/architecture.md)
- [故障排除和配置](docs/troubleshooting.md)
## 项目笔记
- CLI模式使用OpenRouter进行自然语言工具选择和查询扩展。
- 默认情况下，搜索是自适应的：如果 `limit` 如果省略，该工具可以在内部分页多达50个最终结果；明确的一次性搜索请求上限为100。
- 高级评论收集仅返回根评论，每个媒体最多可以对100条评论进行内部分页。
- MCP模式在内部不使用OpenRouter进行搜索。MCP客户端可以通过 `query_variants` 当需要更丰富的多语言检索时。
- Python库模式使用相同的确定性 `InstagramOps` 层作为CLI和MCP服务器，通过 `InstagramClient`.
- 默认情况下，昂贵的追随者和喜欢者分析被故意限制，以避免烧毁HikerAPI积分。
- 一些工具是精确的页面读取，而抽样排名工具明确地将自己标记为近似值。