🔍 Behance MCP Server

A powerful Model Context Protocol (MCP) server for scraping Behance.net. Extract projects, user profiles, images, and job listings from Behance's creative community without any API keys or subscriptions.

✨ Features

• 🔍 Search Projects - Find creative projects by keyword with full metadata (title, creator, stats, fields)
• 👤 User Profiles - Extract designer and agency profile information
• 🖼️ Images - Search and collect images from Behance portfolios
• 💼 Jobs - Get creative job listings with filters (location, category, remote)
• 📊 Detailed Data - Comprehensive information including descriptions, tools, tags, and media
• 🔒 No API Key Required - Uses web scraping, no Behance API key needed
• 💰 Completely Free - No monthly fees or usage limits (unlike Apify's $25/month)

🚀 Quick Start

Prerequisites

• Node.js 18 or higher
• npm (comes with Node.js)

Installation

# Clone the repository
git clone https://github.com/Arnonfr/behance-mcp-server.git
cd behance-mcp-server

# Install dependencies
npm install

# Build the TypeScript code
npm run build

Alternative: Install via npx (Coming Soon)

npx behance-mcp-server

⚙️ Configuration

Claude Desktop

Add to your Claude Desktop configuration file:

macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Windows:

%APPDATA%/Claude/claude_desktop_config.json

Linux:

~/.config/Claude/claude_desktop_config.json

Configuration:

{
  "mcpServers": {
    "behance": {
      "command": "node",
      "args": ["/absolute/path/to/behance-mcp-server/dist/index.js"]
    }
  }
}

Cursor

Add to your Cursor MCP settings (Settings → Features → MCP):

{
  "mcpServers": {
    "behance": {
      "command": "node",
      "args": ["/absolute/path/to/behance-mcp-server/dist/index.js"]
    }
  }
}

VS Code / GitHub Copilot

{
  "mcpServers": {
    "behance": {
      "command": "node",
      "args": ["/absolute/path/to/behance-mcp-server/dist/index.js"]
    }
  }
}

Kimi Code CLI

Add to your Kimi MCP configuration (~/.kimi/mcp.json):

{
  "mcpServers": {
    "behance": {
      "command": "node",
      "args": ["/absolute/path/to/behance-mcp-server/dist/index.js"]
    }
  }
}

🛠️ Available Tools

1. search_behance_projects

Search for creative projects on Behance.

Parameters:

• keyword (string, required): Search term (e.g., "branding", "UI design")
• maxItems (number, optional): Maximum results (default: 50, max: 200)

Returns:

• Project ID, title, URL
• Creator name and profile URL
• Thumbnail image
• Stats: views, appreciations, comments
• Creative fields/categories

Example:

{
  "keyword": "logo design",
  "maxItems": 10
}

2. get_behance_project_details

Get detailed information about a specific project.

Parameters:

• projectUrl (string, required): Full Behance project URL

Returns:

• Full description
• All project images
• Tags
• Tools used

Example:

{
  "projectUrl": "https://www.behance.net/gallery/123456789/Project-Name"
}

3. search_behance_profiles

Search for user profiles on Behance.

Parameters:

• keyword (string, required): Search term (e.g., "designer", "illustrator")
• maxItems (number, optional): Maximum results (default: 50, max: 200)

Returns:

• Username and display name
• Avatar image
• Location
• Followers, appreciations, views
• Project count
• Hiring status

Example:

{
  "keyword": "UI designer London",
  "maxItems": 20
}

4. get_behance_profile_details

Get detailed profile information.

Parameters:

• profileUrl (string, required): Full Behance profile URL

Returns:

• Bio
• Company and occupation
• Social media links
• Complete statistics

Example:

{
  "profileUrl": "https://www.behance.net/username"
}

5. search_behance_images

Search for images on Behance.

Parameters:

• keyword (string, required): Search term (e.g., "logo", "3d render")
• maxItems (number, optional): Maximum results (default: 50, max: 200)

Returns:

• Image URLs with dimensions
• Associated project info
• Creator details

Example:

{
  "keyword": "3d render",
  "maxItems": 30
}

6. get_behance_jobs

Get job listings from Behance.

Parameters:

• maxItems (number, optional): Maximum results (default: 50, max: 100)
• location (string, optional): Filter by location (e.g., "New York", "Remote")
• category (string, optional): Filter by category (e.g., "Graphic Design")

Returns:

• Job title and company
• Location and job type
• Posted date
• Required skills
• Remote availability

Example:

{
  "maxItems": 20,
  "location": "Remote",
  "category": "UI/UX"
}

7. get_behance_job_details

Get detailed job listing information.

Parameters:

• jobUrl (string, required): Full Behance job URL

Returns:

• Full job description
• Salary information (if available)

💡 Usage Examples

Search for branding projects:

Search for "branding" projects on Behance, limit to 20 results

Find designers in a location:

Search for UI designer profiles in London

Get job listings:

Get remote graphic design jobs from Behance

Extract project details:

Get full details for project https://www.behance.net/gallery/123456789/Project-Name

🏗️ Development

# Install dependencies
npm install

# Build the project
npm run build

# Watch mode for development
npm run dev

# Run the server
npm start

🧪 Testing

Run the test suite:

npm test

🔧 Troubleshooting

Browser not launching

Make sure you have Chrome/Chromium installed. Puppeteer will download Chromium automatically on first run.

# If Puppeteer fails to download Chromium, try:
PUPPETEER_SKIP_DOWNLOAD=true npm install
npx puppeteer browsers install chrome

Timeout errors

Behance may have rate limiting. Try reducing maxItems or adding delays between requests.

Memory issues

For large scraping operations, consider running with increased Node.js memory:

node --max-old-space-size=4096 dist/index.js

macOS permissions

If you get permission errors on macOS:

# Allow the binary to run
xattr -dr com.apple.quarantine node_modules/puppeteer/.local-chromium/*/chrome-mac/Chromium.app

💰 Pricing Comparison

Feature	Behance MCP Server	Apify Behance Scraper
Monthly Cost	FREE	$25/month + usage
API Key Required	No	Yes
Rate Limits	None (respectful scraping)	Varies
Setup Time	5 minutes	2 minutes
Open Source	✅ Yes	❌ No
Self-hosted	✅ Yes	❌ No

📁 Project Structure

behance-mcp-server/
├── src/
│   ├── index.ts          # MCP server implementation
│   └── scraper.ts        # Behance scraping logic
├── dist/                 # Compiled JavaScript
├── package.json          # Dependencies and scripts
├── tsconfig.json         # TypeScript configuration
├── config-example.json   # Example MCP configuration
├── LICENSE               # MIT License
└── README.md            # This file

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

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

Development Setup

# Fork and clone
git clone https://github.com/YOUR_USERNAME/behance-mcp-server.git
cd behance-mcp-server

# Install dependencies
npm install

# Create a branch
git checkout -b feature/my-feature

# Make changes and test
npm run build
npm test

# Commit and push
git commit -m "Add my feature"
git push origin feature/my-feature

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Built with Model Context Protocol
• Uses Puppeteer for browser automation
• Inspired by the need for free, open-source data extraction tools
• Thanks to all contributors!

📧 Support

If you encounter any issues or have questions:

1. Check the Troubleshooting section
2. Open an issue on GitHub
3. Join the discussion in the Discussions tab

🔒 Security

This project uses Puppeteer for web scraping. Please use responsibly and respect Behance's terms of service. The scraper includes rate limiting and respectful crawling practices.

---

Made with ❤️ for the creative community

If you find this project useful, please ⭐ star the repository!