n8n-nodes-marketing-architects-node

This is an n8n community node that allows you to integrate Marketing Architects API into your n8n workflows.

Marketing Architects is a platform for creating and managing marketing campaigns, providing AI-powered text completion, image generation, and project management capabilities.

n8n is a fair-code licensed workflow automation platform.

Table of Contents

• Installation
• Operations
• Credentials
• Compatibility
• Usage
• Resources
• Version history
• Development
• Adding New Features
• Version Management
• Publishing to npm

Installation

Follow the installation guide in the n8n community nodes documentation.

Operations

This node provides five main resource types with the following operations:

Brand Resource

• Get Brand Info: Retrieve brand information and insights for a given domain

Text Resource

• Text Completion: Generate AI-powered text completions for given prompts using the OpenRouter API

Image Resource

• Image Generation: Create AI-generated images from text prompts using Replicate API

Video Resource

• Video Generation: Create AI-generated videos from text prompts using advanced video generation APIs
• Analyze Video: Analyze video content from a given URL to extract insights and metadata

Project Resource

• Log Event: Log events to track project activities and workflow executions

Credentials

The Marketing Architects API requires authentication using the following credentials:

• Token: Your Marketing Architects API bearer token for authentication
• Domain: The API endpoint URL (defaults to https://pushbtn.api.misfitsandmachines.com)

To obtain your API credentials, visit the Marketing Architects API Documentation.

Compatibility

• n8n 1.110.1 and above
• Node.js 20.15 and above

Usage

Basic Setup

1. Install the node following the installation guide
2. Configure your Marketing Architects API credentials
3. Add the Marketing Architects node to your workflow
4. Select the desired resource (Brand, Text, Image, Video, or Project) and operation
5. Configure the operation parameters and execute your workflow

Resources

• n8n community nodes documentation
• Marketing Architects API Documentation
• Repository

Development

Prerequisites

• Node.js 20.15 or higher
• npm package manager

Run an initial build and make it linkable to n8n

npm run build
npm link

List nodes and credentials in package.json

"n8n": {
  "n8nNodesApiVersion": 1,
  "credentials": [
    "dist/credentials/MarketingArchitectsApi.credentials.js"
  ],
  "nodes": [
    "dist/nodes/MarketingArchitects/MarketingArchitects.node.js"
  ]
}

Link build to n8n

# In the nodes directory within your n8n installation
cd ~/.n8n/nodes

# node-package-name is the name from the package.json
npm link n8n-nodes-marketing-architects-node

Start n8n and see your node

n8n start

Development Commands

# Build the project
npm run build

# Watch for changes during development
npm run dev

# Format code
npm run format

# Lint code
npm run lint

# Fix linting issues
npm run lintfix

Restart n8n to see your changes

n8n start

Adding New Features

1. Create New Operation Files

When adding new operations, create corresponding files in the nodes/MarketingArchitects/ directory:

# Example: Adding a new "Analytics" resource
touch nodes/MarketingArchitects/Analytics.ts

2. Update Main Node File

Add your new resource and operations to MarketingArchitects.node.ts:

// Import your new operation fields
import { analyticsFields } from './Analytics';

// Add to properties array
properties: [
	// ... existing resources
	{
		displayName: 'Analytics',
		name: 'analytics',
		value: 'analytics',
	},
	// ... existing operations
	...analyticsFields,
];

3. Update Node Configuration

Modify MarketingArchitects.node.json if needed:

{
	"node": "n8n-nodes-base.marketingArchitects",
	"nodeVersion": "1.1", // Increment when adding features
	"categories": ["Utility", "Marketing", "Analytics"] // Add new categories
}

4. Test Your Changes

# Build and test
npm run build
npm run lint
npm run format

# Link to n8n and test
npm link
cd ~/.n8n/nodes
npm link n8n-nodes-marketing-architects-node
n8n start

Publishing to npm

Automated GitHub Actions Workflow

This project includes an automated GitHub Actions workflow that handles the entire publishing process. This is the recommended approach for publishing new versions.

Setup (already done)

1. Add NPM_TOKEN to GitHub Secrets:
   • Generate a token at npmjs.com/settings/tokens
   • Add to GitHub: Settings → Secrets and variables → Actions → New repository secret
   • Name: NPM_TOKEN, Value: your npm publish token

Publishing a New Version

1. Commit your changes to main branch
2. Go to Actions → Manual Release & Publish
3. Click "Run workflow"
4. Choose version type (patch/minor/major)
5. Add optional release notes
6. Click "Run workflow"

The workflow automatically:

• ✅ Runs quality checks (linting, formatting, build)
• ✅ Bumps version in package.json
• ✅ Updates README version history
• ✅ Publishes to npm
• ✅ Creates GitHub release with installation instructions

Testing Before Publishing

Use the "Skip npm publish" option to test version bumping and GitHub releases without actually publishing to npm.

Manual CLI Publishing (Alternative)

If you prefer manual publishing:

# Build and quality checks
npm run build
npm run lint
npm run format

# Bump version and publish
npm version patch  # or minor/major
npm publish

# Create GitHub release
git tag v$(node -p "require('./package.json').version")
git push origin --tags

Note: Manual publishing requires npm login and doesn't include automated quality checks or documentation updates.