Description

n8n-nodes-facebook-pro

⚠️ DISCLAIMER: This package uses cookie-based authentication which violates Facebook's Terms of Service. Use at your own risk. Accounts may be suspended or banned.

A comprehensive n8n custom node for Facebook automation using cookie-based authentication. Interact with Pages, Groups, User profiles, Media, Comments, and Messages programmatically.

Features

• ✅ 7 Resource Categories: Page, Group, User, Media, Comment, Message, Utility
• ✅ 31+ Operations: Complete coverage of Facebook actions
• ✅ Cookie-Based Auth: No OAuth tokens required
• ✅ Clean JSON Output: Normalized responses with ISO timestamps
• ✅ Chunked Video Upload: Support for large files (>1GB)
• ✅ Multi-Image Albums: Upload 2-10 images in single album
• ✅ Proxy Support: Built-in proxy configuration
• ✅ Automatic Retry: Exponential backoff for failed requests

Installation

Community Nodes (Recommended)

1. Open n8n
2. Go to Settings → Community Nodes
3. Search for n8n-nodes-facebook-pro
4. Click Install

Manual Installation

# Navigate to your n8n custom nodes directory
cd ~/.n8n/custom

# Install the package
npm install n8n-nodes-facebook-pro

# Restart n8n

From Source

# Clone this repository
git clone https://github.com/yourusername/n8n-nodes-facebook-pro.git
cd n8n-nodes-facebook-pro

# Build the package
npm install
npm run build

# Create installable package
npm pack

# Install in n8n
npm install -g /path/to/n8n-nodes-facebook-pro-1.0.0.tgz

Getting Started

1. Extract Facebook Cookies

Using Chrome DevTools:

1. Open Facebook in Chrome and log in

2. Press F12 to open DevTools

3. Go to Application → Cookies → https://www.facebook.com

4. Copy the following cookie values:

   • c_user
   • xs
   • datr
   • fr (optional)
   • sb (optional)

5. Format as string:

   c_user=123456789; xs=abc123def456; datr=xyz789; fr=...
   

⚠️ Security Warning: Never share your cookies publicly. They grant full access to your Facebook account.

2. Configure Credentials in n8n

1. In n8n, create a new Facebook PRO (Cookie) credential
2. Paste your cookie string
3. (Optional) Add proxy URL: http://username:password@proxy.com:8080
4. (Optional) Customize User-Agent
5. Click Save

3. Create Your First Workflow

Example: Create Page Post

1. Add node → Facebook PRO
2. Select credential
3. Resource: Page
4. Operation: Create Text Post
5. Page ID: your-page-id
6. Message: Hello from n8n!
7. Execute

Operations Reference

📄 Page (7 Operations)

👥 Group (6 Operations)

👤 User (5 Operations)

🎬 Media (2 Operations)

💬 Comment (4 Operations)

📨 Message (3 Operations)

🔧 Utility (4 Operations)

Advanced Examples

Scheduled Reel Publishing

{
  "nodes": [
    {
      "name": "Schedule",
      "type": "n8n-nodes-base.scheduleTrigger",
      "parameters": {
        "rule": { "interval": [{ "field": "hours", "hoursInterval": 6 }] }
      }
    },
    {
      "name": "Facebook PRO",
      "type": "n8n-nodes-facebook-pro.facebookPro",
      "parameters": {
        "resource": "page",
        "operation": "createReel",
        "pageId": "123456789",
        "videoUrl": "https://example.com/reel.mp4",
        "description": "Daily automation reel! 🚀"
      }
    }
  ]
}

Multi-Image Album with Dynamic URLs

{
  "name": "Upload Album",
  "type": "n8n-nodes-facebook-pro.facebookPro",
  "parameters": {
    "resource": "media",
    "operation": "uploadAlbum",
    "pageId": "{{$json.pageId}}",
    "imageUrls": "{{$json.images.join(', ')}}",
    "message": "Check out our new products!"
  }
}

Auto-Reply to Comments

{
  "nodes": [
    {
      "name": "Webhook",
      "type": "n8n-nodes-base.webhook",
      "parameters": {
        "path": "facebook-comment"
      }
    },
    {
      "name": "Facebook PRO",
      "type": "n8n-nodes-facebook-pro.facebookPro",
      "parameters": {
        "resource": "comment",
        "operation": "reply",
        "commentId": "={{$json.comment_id}}",
        "message": "Thanks for your comment! 😊"
      }
    }
  ]
}

Security Best Practices

1. Use Residential Proxies

Datacenter IPs are easily detected by Facebook. Use residential proxies:

http://username:password@residential-proxy.com:8080

2. Implement Request Delays

Don't spam requests. Add delays between actions:

• Posting: Wait 2-5 minutes between posts
• Commenting: Wait 30-60 seconds between comments
• Messaging: Wait 1-2 minutes between messages

3. Rotate User-Agents

Change User-Agent periodically to mimic different devices:

const userAgents = [
  'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36',
  'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36',
  'Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36'
];

4. Monitor for Checkpoints

Facebook may trigger security checkpoints. Signs:

• Unexpected login prompts
• CAPTCHA requirements
• "Suspicious activity" warnings

Solution: Refresh cookies, use cleaner proxies, reduce activity frequency.

5. Cookie Refresh Strategy

Cookies expire after ~30-90 days. Automate refresh:

1. Use Validate Cookies operation daily
2. If validation fails, extract new cookies
3. Update credential in n8n

Troubleshooting

Error: "Invalid or expired cookies"

Cause: Cookies are no longer valid

Solution:

1. Log out of Facebook completely
2. Clear browser cookies
3. Log in again
4. Extract fresh cookies
5. Update n8n credential

Error: "Temporarily blocked – Facebook detected unusual activity"

Cause: Too many requests too quickly (Error 368)

Solution:

• Wait 1-24 hours before retrying
• Use residential proxies
• Reduce request frequency
• Spread automation across multiple accounts

Error: "Permission denied"

Cause: Your account doesn't have access to the resource

Solution:

• Verify you're admin/editor of the Page/Group
• Check if your account is restricted
• Try with a different account

Uploads Failing

Cause: Network issues or file too large

Solution:

• Enable Use Chunked Upload for videos >25MB
• Check proxy configuration
• Verify file URL is publicly accessible
• Increase timeout in credentials (default: 30000ms)

Proxy Not Working

Cause: Invalid proxy format or proxy server down

Solution:

1. Test proxy with Test Proxy operation
2. Verify proxy format: http://user:pass@host:port
3. Try different proxy provider
4. Check if proxy supports HTTPS

API Rate Limits

Facebook has undocumented rate limits. Observed limits:

Tips:

• Spread actions across time
• Use multiple Facebook accounts
• Monitor for error code 4 (rate limit)

Development

Clone & Build

git clone https://github.com/yourusername/n8n-nodes-facebook-pro.git
cd n8n-nodes-facebook-pro
npm install
npm run build

Run Tests

npm test

Lint

npm run lint
npm run lintfix

Local Development with n8n

# Link package
npm link

# In n8n directory
npm link n8n-nodes-facebook-pro

# Start n8n in dev mode
n8n start

Project Structure

n8n-nodes-facebook-pro/
├── credentials/
│   └── FacebookProApi.credentials.ts
├── nodes/
│   └── FacebookPro/
│       ├── FacebookPro.node.ts
│       └── facebook.svg
├── actions/
│   ├── page.ts
│   ├── group.ts
│   ├── user.ts
│   ├── media.ts
│   ├── comment.ts
│   ├── message.ts
│   └── utility.ts
├── utils/
│   ├── FacebookApiClient.ts
│   ├── ResponseCleaner.ts
│   ├── MediaUploader.ts
│   └── ErrorHandler.ts
├── types/
│   └── index.ts
└── package.json

Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Commit changes: git commit -m 'Add amazing feature'
4. Push to branch: git push origin feature/amazing-feature
5. Open a Pull Request

License

MIT License – see LICENSE file

Disclaimer

This project is not affiliated with, endorsed by, or connected to Facebook/Meta in any way. Use of this package violates Facebook's Terms of Service. The authors are not responsible for:

• Account suspensions or bans
• Data loss
• Legal consequences
• Any damages resulting from use of this package

Use at your own risk.

Support

• 🐛 Issues: GitHub Issues
• 💬 Discussions: GitHub Discussions
• 📧 Email: your.email@example.com

Changelog

See CHANGELOG.md for version history.

Made with ❤️ for the n8n community