DSH Instagram Scroll Feed & Exploration Plugin (@luoyi-dsh/instagram-scroll)
Dedicated Instagram feed exploration, AI content review, and daily digest plugin for DeepSeek Harness (DSH).
Automatically inherits Bot and Master accounts from @luoyi-dsh/instagram-mcp, browses Instagram timeline feeds and fuzzy-searched topics, strictly filters out AI-generated videos/animations/articles (AIGC), evaluates post substance against the owner's interests via LLM, leaves authentic @master recommendation comments, and compiles daily Markdown reports.
[!CAUTION]
⚠️ CRITICAL WARNING & DISCLAIMER
- Violation of Instagram Terms of Service & Community Guidelines:
This plugin operates via unofficial APIs, which expressly violates Instagram / Meta's Terms of Use and Community Guidelines.
- DO NOT USE YOUR PERSONAL / PRIMARY ACCOUNT:
Never run this plugin using your personal, primary, or business Instagram account! Use disposable test accounts paired with clean residential proxies.
- Disclaimer:
This project is provided strictly for educational and technical research purposes. Use entirely at your own risk!
🌟 Key Features
- Zero-Config Account Inheritance:
- Automatically inherits both the Bot session (
username) and Master account (masterUsername) from @luoyi-dsh/instagram-mcp.
- Automated Feed & Fuzzy Topic Exploration (Scroll Duty):
- Periodically polls timeline feeds and fuzzy-searches configured topics (
igFuzzySearchPosts + hashtag fallback).
- Strict Anti-AIGC & Deep Content Inspection:
- Automatically rejects AI-generated videos, animations, images, and content-farm articles, as well as hashtag spam, giveaways, and superficial posts.
- Evaluates genuine body text via LLM (supporting external
dsh-plugin-subscriptions quota) before recommending to the master.
- Daily Markdown Digest (
data/reports/YYYY-MM-DD.md):
- Organizes reviewed posts, summaries, and recommendation trails into daily Markdown reports viewable in the Web UI.
📦 Installation
# Via DSH Plugin CLI
dsh plugin --profile web add @luoyi-dsh/instagram-scroll
# Or via npm
npm install @luoyi-dsh/instagram-scroll
📖 Operational Guide & Tool Reference
For complete DSH tool definitions, natural language prompts, HTTP REST API routes, and configuration parameters, please refer to AGENTS.md.
📁 Directory Structure
dsh-instagram-scroll/
├── cordis.patch.yml # DSH bundle patch manifest
├── package.json # Module definitions and dependencies
├── tsconfig.json # TypeScript compiler configuration
├── AGENTS.md # Operational & Agent Tool Guide
├── CHANGELOG.md # Version release notes
├── README.md # English overview (This file)
├── README.zh-Hant.md # Traditional Chinese overview
├── client.js # DSH Web UI panel
└── src/ # Core scroll duty, ledger/report manager, and DSH tools
📜 Releases & License
