中文版

SeedLens

Marketing automation MCP server — crawl pages, extract SEO data & contacts, send marketing emails.

Overview

SeedLens is a Model Context Protocol (MCP) server that turns any AI assistant (Claude, Cursor, VS Code Copilot, etc.) into a marketing automation tool. It provides 4 tools:

Tech Stack

• TypeScript (ESM) + @modelcontextprotocol/sdk v2
• Zod v4 — input/output schema validation for all tools
• Playwright — headless Chromium browser for page crawling
• Nodemailer — SMTP email delivery (QQ Mail, Gmail, etc.)
• React Email — inline-styled HTML email templates
• Vitest — testing framework

Quick Start

Prerequisites

• Node.js >= 18
• npm

Install

npm install
npx playwright install chromium

Configure

Copy the example env file and fill in your SMTP credentials:

cp .env.example .env

.env fields:

Build & Run

# Build
npm run build

# Run (stdio transport)
npm start

# Dev mode (no build needed)
npm run dev

Test

npm test

IDE Integration

Claude Code

The MCP server is auto-configured via .claude/settings.local.json. After building, restart Claude Code and the 4 tools will be available.

Cursor

Configured via .cursor/mcp.json. Set SMTP environment variables in your shell or .env before launching.

VS Code

Configured via .vscode/mcp.json with input prompts — you'll be asked for SMTP credentials on first run.

Project Structure

seedlens/
├── src/
│   ├── index.ts                       # Entry: register tools + stdio transport
│   ├── config/env.ts                  # Environment variable validation (Zod)
│   ├── i18n/strings.ts                # Email i18n strings + subject template resolver
│   ├── schemas/
│   │   ├── common.schema.ts           # URL, timestamp, ExtractionMeta
│   │   ├── contact.schema.ts          # Contact extraction input/output
│   │   ├── seo.schema.ts             # SEO data input/output
│   │   └── email.schema.ts           # Email tool input/output
│   ├── services/
│   │   ├── browser-manager.ts         # Playwright singleton + withPage()
│   │   ├── contact-extractor.ts       # Contact DOM extraction
│   │   ├── seo-extractor.ts          # SEO DOM extraction
│   │   └── email-service.ts          # Nodemailer + React Email rendering
│   ├── templates/
│   │   └── marketing-email.tsx        # React Email marketing template
│   └── tools/
│       ├── extract-contacts.ts        # extract_contacts tool registration
│       ├── extract-seo-data.ts        # extract_seo_data tool registration
│       ├── send-marketing-email.ts    # send_marketing_email tool registration
│       └── preview-marketing-email.ts # preview_marketing_email tool registration
├── tests/
│   ├── setup.ts                       # Vitest global setup/teardown
│   ├── extract-contacts.test.ts
│   ├── extract-seo-data.test.ts
│   ├── preview-marketing-email.test.ts
│   ├── resolve-subject.test.ts
│   └── send-marketing-email.test.ts
├── package.json
├── tsconfig.json
└── vitest.config.ts

Architecture

Browser Manager

A singleton Playwright browser instance is reused across requests to avoid the 1-3s cold start per launch. Each tool call gets an isolated BrowserContext via withPage(url, fn), ensuring no cookie/state leakage between requests. The browser is automatically cleaned up on process exit.

Single page.evaluate()

All DOM queries (contacts, SEO data) are executed in a single page.evaluate() call, minimizing IPC round-trips between Node.js and the browser for optimal performance.

Email Rendering

Marketing emails are built with React Email components using inline CSS styles for maximum email client compatibility. The renderEmail() function produces both HTML and plain text versions.

Schema Validation

Every tool uses Zod schemas for both inputSchema and outputSchema, providing type-safe validation and enabling MCP clients to understand the data structure.

Usage Examples

Once connected to an MCP client, you can use natural language:

"Extract contact information from https://example.com"

"Analyze the SEO of https://example.com"

"Analyze https://example.com, find the owner's email, and send them a marketing email about their SEO issues"

"Preview a marketing email for Bob about his website's missing meta descriptions"

License

MIT