dsh-instagram-scroll

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

1. 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.
2. 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.
3. Disclaimer: This project is provided strictly for educational and technical research purposes. Use entirely at your own risk!

---

🌟 Key Features

1. Zero-Config Account Inheritance:
   • Automatically inherits both the Bot session (username) and Master account (masterUsername) from @luoyi-dsh/instagram-mcp.
2. Automated Feed & Fuzzy Topic Exploration (Scroll Duty):
   • Periodically polls timeline feeds and fuzzy-searches configured topics (igFuzzySearchPosts + hashtag fallback).
3. 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.
4. 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

• See CHANGELOG.md for release history.
• Licensed under the MIT License.