🔍 Behance MCP Server

![MCP](https://modelcontextprotocol.io/) ![Node.js](https://nodejs.org/) ![TypeScript](https://www.typescriptlang.org/) ![License](LICENSE) ![npm](https://www.npmjs.com/package/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: ``bash ~/Library/Application Support/Claude/claude_desktop_config.json ``

Windows: ``bash %APPDATA%/Claude/claude_desktop_config.json ``

Linux: ``bash ~/.config/Claude/claude_desktop_config.json ``

Configuration: ``json { "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: ``json { "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: ``json { "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: ``json { "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: ``json { "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: ``json { "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: ``json { "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: ``bash node --max-old-space-size=4096 dist/index.js ``

macOS permissions

If you get permission errors on macOS: ```bash

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.

Fork the repository
Create your feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
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:

Check the Troubleshooting section
Open an issue on GitHub
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!

Behance MCP Server