open-index/open-npm huggingface dataset:
npm package: @jrdlcrz1808/mailman
Description: A reusable automated outreach system for international B2B suppliers.
Latest version: 1.0.0

# Automated Outreach Framework

A reusable system for researching international suppliers, crafting culturally-aware communication, and automating personalized email outreach.

## Overview

This framework was developed during a procurement project targeting Chinese hotel furniture manufacturers for a 5-star hotel in the Philippines. The methodology is designed to be **industry-agnostic** and can be applied to any B2B international supplier outreach scenario.

## Core Components

| Component | Purpose | File |
|-----------|---------|------|
| **Research Protocol** | How to identify and verify legitimate suppliers | [RESEARCH.md](./RESEARCH.md) |
| **Template Design** | Principles for culturally-aware email composition | [TEMPLATE_DESIGN.md](./TEMPLATE_DESIGN.md) |
| **Automation Script** | Technical implementation for mail-merge and Gmail integration | [AUTOMATION.md](./AUTOMATION.md) |
| **Verification Checklist** | Anti-fraud framework for international procurement | [VERIFICATION.md](./VERIFICATION.md) |

## Quick Start

1. **Bootstrap**: Run `/initialize` to have the agent guide you through setting up a new project.
2. **Define Industry**: Provide project details when prompted.
3. **Research**: Populate `suppliers.json` with verified contact data.
4. **Automate**: Run the outreach script using the `--draft` flag.

## Commands

| Command | Action |
|---------|--------|
| `/initialize` | Starts the workspace bootstrap and project discovery process. |
| `mailman` | The CLI tool for generating drafts or sending emails. |

## How to Share (NPM)

Want to show this to a buddy? See the [Publishing Guide](./PUBLISHING_GUIDE.md) to learn how to turn this framework into a globally installable command called `mailman`. (Project name: `@jrdlcrz1808/mailman`)

## Workflow Diagram

```
┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│   1. RESEARCH   │────▶│  2. TEMPLATE    │────▶│  3. AUTOMATE    │
│   (suppliers)   │     │    (design)     │     │   (send/draft)  │
└─────────────────┘     └─────────────────┘     └─────────────────┘
        │                       │                       │
        ▼                       ▼                       ▼
   suppliers.json          templates.md           Gmail Drafts
```

## Proof of Concept

This framework was validated in a live project where 6 verified Chinese furniture suppliers received personalized outreach emails. Key suppliers included Harman (Shangri-La at the Fort) and SunsGoods (Belmont Hotel Mactan).