n8n-nodes-magic-dev/README.md

🪄 Magic Dev - Revolutionary community n8n node: AI Generation, Creator Hub, Quest Unlock, Market, P2P Magic Inbox (send & receive)!

# 🪄 n8n-nodes-magic-dev

> **The next-level n8n extension: A.I. workflow generation, Community Market, Quest Unlocking, Creator Hub, and fully decentralized Magic Inbox (Send & Receive, P2P/Forum)!**

---

## 🚀 Main Features

- **MagicDev Action Node**
  - **AI Generation**: Instantly create custom workflows through OpenRouter/Claude and teleport them to your n8n instance.
  - **Creator Hub**: Discover and import creative, community and premium workflows from respected n8n creators.
  - **Quest Unlock**: Collect clues and unlock “golden” workflows using special codes found across the Magic Dev ecosystem.
  - **Magic Market**: Search and publish workflows to a public Google Sheets-powered marketplace, with direct one-click teleportation into your instance.
  - **Magic Inbox SEND (P2P/Forum)**: Securely transmit messages or entire workflows directly to any peer or to a public forum node (safeguarded communications, instant feedback).
  - **Experience Feedback**: Rate each experience with 1-20 stars and share comments to improve the ecosystem.

- **Magic Inbox Receiver (Trigger Node)**
  - **Receive workflows/messages** from any MagicDev SEND node (peer-to-peer or open forum).
  - **Simple Mode**: Instantly auto-imports workflow into your instance.
  - **Advanced Mode**: Lets you parse and process incoming data as you wish.
  - **Whitelist Security**: Restrict acceptance to approved senders for maximum safety.
  - **Blue Gift Icon**: Consistent, recognizable look—inspired by the Magic Dev spirit!

---

## 💡 How It Works

- **MagicDev Node** supports multiple modes:  
  - _AI Generation_ – autogenerates workflows using Claude/OpenRouter.
  - _Creator Mapping_ – fetches ready-to-use productivity flows.
  - _Quest Unlock_ – enter hidden codes to unlock exclusive creations.
  - _Market_ – search & publish automation workflows for the community.
  - _Magic Inbox SEND_ – deposit a message or workflow to peer/forum.
- **Magic Inbox Receiver (Trigger)**  
  - Add to any workflow to receive messages or workflows at `/webhook/magic-inbox`.
  - In "Simple" mode, works plug-and-play for direct workflow importing.
  - Powerful Advanced mode for custom parsing, validation, or multi-step ingestion.

---

## 📦 Installation

npm install n8n-nodes-magic-dev

- Then **restart your n8n instance** (required).

---

## 🧭 Usage

1. **Open n8n UI and search:**
   - _MagicDev_: Find in main nodes ("Actions")
   - _Magic Inbox Receiver_: Appears in triggers
2. **Configure each mode** using dropdowns and blue "?" tooltips (hover for instant guidance!)
3. **For Market and teleport**, ensure your Google Sheet contains a `WORKFLOW` column (all caps, no spaces).
4. **Protect your inbox**: When using Magic Inbox Receiver, set up the whitelist with trusted sender emails or URLs for additional security.
5. **Send a workflow/message** to anyone with their Magic Inbox URL—cross-instance, cross-community!

---

## 📑 Example Scenarios

- **Teleport a generated workflow directly to your instance** with just your API key and URL.
- **Send a workflow to a friend’s Magic Inbox** or to the public forum; they receive and auto-import it!
- **Unlock premium content** by solving creative quests and entering codes found throughout the Magic Dev network.
- **Share or find inspiration** on the open Magic Market and retrieve any flow instantly.

---

## 🛡️ Security & Best Practices

- Always store your API Keys safely and never share them publicly.
- Use the Whitelist mode on triggers to limit unwanted submissions.
- For Market teleportation to work, the Google Sheet column name for JSON must be `WORKFLOW` (uppercase, no spaces).

---

## 🛠️ Developer / Maintenance Commands

nano nodes/MagicDev/MagicDev.node.ts # Edit main node source
nano nodes/MagicInboxReceiver/MagicInboxReceiver.trigger.ts # Edit trigger node
nano package.json # Edit package metadata
npm install # Install dependencies
npm run build # Compile the TypeScript code
npm publish # Publish to npm (if owner)


---

## 🤝 Community, Issues & Contact

Want to suggest a new feature, report a bug, or join the creator quest?
- **GitHub**: [https://github.com/CharlesMagicDev](https://github.com/CharlesMagicDev)
- **Email**: charleslepoittevin34@gmail.com

You can also connect via Telegram for support: **@magicdev_bot**

---

## 💝 Credits & Philosophy

Inspired by the creativity and teamwork of the n8n French community—automation magic by Charles, Montpellier, Occitanie 🇫🇷  
_Make workflow sharing, collaboration, and automated questing fun, secure, and limitless!_

---

**⚡ Ready to create, share, and unlock?  
Make your automation magical—with Magic Dev!**