MCPcopy
hub / github.com/growchief/growchief

github.com/growchief/growchief @v0.3.0 sqlite

repository ↗ · DeepWiki ↗ · release v0.3.0 ↗
1,230 symbols 2,616 edges 320 files 1 documented · 0%
README

<img alt="GrowChief Logo" src="https://github.com/user-attachments/assets/50401d55-d870-478a-a5c4-ef6b474e6ccc" width="280"/>

License


Your ultimate social media automation tool (outreach tool)

GrowChief: An alternative to: Phantom Buster, Expandi, Zopto, LinkedIn Helper, Meet Alfred, etc.

GrowChief is an API based tool to automate your social media accounts such as

sending connection requests and follow-up messages. Perfect for n8n / Make / Zapier users

Linkedin X

Explore the docs »

N8N node · Register · Join Our Discord (devs only)

✨ Features

Image 1 Image 2
Image 3 Image 4

Introduction

Growchief is an open-source social media automation tool (aka social scraper). It allows you to create a workflow (step-by-step) for interacting with different accounts on social media, such as sending a connection request, following up with a message, and so on. We do not encourage spam (perfect for API/n8n automations).

Why is GrowChief so good?

  • It takes care of concurrency — even if you create 10 workflows with the same account and trigger all of them at the same time, it will make an action every 10 minutes, never having multiple scrapings happening at the same time.

  • Enrichment waterful — when you don't provide the account URL but other parameters like email, we use multiple provider to figure out the profile URL.

  • It takes care of your working hours — you can use the API to keep adding leads to your workflows, but they will only be processed during working hours.

  • Proxies are allowed — you can add your own proxies or create one using proxy providers to keep you safe.

  • Human-like automation — GrowChief uses natural mouse movements and clicks on different parts of the screen. It never triggers clicks by "document.querySelector('x').click()".

  • It uses Playwright together with Patchright for maximum stealthiness.

  • It uses a special technology to authenticate your accounts — you never need to put your username and password directly into the system.

  • It always runs in headful — our Docker image is already built with xvfb for real human automation.

Things you should know

  • Social media automation is a common practice in businesses, from small ones to enterprises. Yes, even the biggest companies in the world do it. However, it violates the terms of service of the platforms and can result in a ban. Use it at your own risk and connect only with leads you know.

  • GrowChief Docker can work great without scale, as every time you start automation it opens a Chrome browser (perfect for 1–2 accounts). However, once you scale, you need a smarter system (remote browser) with an option to scale, as Chrome consumes a lot of memory. For that, you can use GrowChief Cloud.

Tech Stack

  • PNPM (Monorepo)
  • React (Vite)
  • NestJS (Backend, Workers)
  • Prisma (Default to PostgreSQL)
  • Temporal (Orchestrator)

QuickStart / Installation

View https://docs.growchief.com

Sponsorship

This can be very valuable for Proxies / Lead enrichment companies, feel free to check our sponsorship page.

Extension points exported contracts — how you extend this code

EmailInterface (Interface)
(no doc) [7 implementers]
shared/server/email/email.interface.ts
ProvidersInterface (Interface)
(no doc) [2 implementers]
apps/backend/src/services/auth/providers.interface.ts
BillingInterface (Interface)
(no doc) [2 implementers]
shared/both/billing/billing.interface.ts
ProxyData (Interface)
(no doc)
apps/frontend/src/components/proxies/add.proxy.component.tsx
WorkingHoursState (Interface)
(no doc)
apps/orchestrator/src/utils/working.hours.manager.ts
PermissionInterface (Interface)
(no doc) [10 implementers]
shared/server/billing/permission.interface.ts
ToolParams (Interface)
(no doc)
shared/both/utils/tool.decorator.ts
Notification (Interface)
(no doc)
apps/frontend/src/components/notifications/notifications.component.tsx

Core symbols most depended-on inside this repo

timer
called by 44
shared/both/utils/timer.ts
useFetch
called by 37
apps/frontend/src/utils/use.fetch.tsx
useToaster
called by 23
apps/frontend/src/utils/use.toaster.tsx
makeId
called by 18
shared/both/utils/make.id.ts
useModals
called by 15
apps/frontend/src/utils/store.ts
status
called by 12
apps/backend/src/controllers/bots.controller.ts
createToolTip
called by 11
apps/frontend/src/utils/create.tool.tip.tsx
useDecisionModal
called by 10
apps/frontend/src/utils/use.decision.modal.tsx

Shape

Method 559
Function 326
Class 263
Interface 81
Enum 1

Languages

TypeScript100%

Modules by API surface

shared/server/database/bots/bots.service.ts38 symbols
shared/server/database/bots/bots.repository.ts32 symbols
apps/backend/src/controllers/bots.controller.ts25 symbols
shared/server/database/workflows/workflows.service.ts22 symbols
apps/frontend/src/components/analytics/analytics.component.tsx21 symbols
apps/backend/src/controllers/workflows.controller.ts16 symbols
shared/server/database/users/users.repository.ts15 symbols
shared/server/database/workflows/workflows.repository.ts14 symbols
shared/server/database/users/users.service.ts14 symbols
shared/server/bots/providers/linkedin/linkedin.provider.ts14 symbols
apps/orchestrator/src/activities/workflow.information.activity.ts14 symbols
apps/frontend/src/components/billing/billing.component.tsx14 symbols

Dependencies from manifests, versioned

@aws-sdk/client-s33.864.0 · 1×
@dagrejs/dagre1.1.5 · 1×
@eslint/eslintrc3.2.0 · 1×
@eslint/js9.32.0 · 1×
@hookform/resolvers5.2.1 · 1×
@langchain/openai0.6.9 · 1×
@nestjs/cli11.0.0 · 1×
@nestjs/common11.0.1 · 1×
@nestjs/core11.0.1 · 1×
@nestjs/microservices11.1.6 · 1×
@nestjs/platform-express11.0.1 · 1×
@nestjs/platform-socket.io11.1.6 · 1×

Datastores touched

growchief-db-localDatabase · 1 repos

For agents

$ claude mcp add growchief \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact