Foreword

DeepSeek Harness (DSH) uses a plugin-based architecture, designed to inject specialized capabilities into agents. dsh-waimao is a plugin focused on the foreign-trade customer acquisition process, maintained by developer shine-233. It integrates the fragmented steps in traditional foreign trade, from finding leads to closing deals and collecting payment, into DSH conversations and workflows. Through a rules engine, AI scoring, and automated execution, it enables end-to-end customer development and management.

Installation and Dependencies

The plugin is built on the @deepseek-ai/dsh 0.1.0-rc.7 plugin interface and has no additional npm dependencies. The runtime environment must be Node.js ≥ 22.13.

Run the following command to install it:

npx -y @deepseek-ai/dsh plugin --profile web add github:shine-233/dsh-waimao

After installation, restart the dsh web service.

Core Capabilities

The plugin covers the full set of features for foreign-trade outreach emails, lead discovery, CRM management, and compliance risk control.

1. ICP Profiling and Lead Discovery

Use the icp_set command to define product and buyer profiles. The system employs a three-layer search strategy (basic search, LinkedIn job targeting, and procurement signals), combined with 18 market presets, to extract information from Google Maps business data. Search results support layered deduplication and CSV export.

2. Lead Processing and Scoring

Captured web data is filtered by the rules engine to exclude invalid information such as competitors, B2B marketplaces, and directories. The system uses AI to score leads from 0 to 12, distinguishing four tiers: extremely high, high, medium, and low. It also provides a fit assessment and follow-up recommendations. Qualified leads are automatically merged into the CRM.

3. Email Discovery and Verification

It includes 35+ email-guessing patterns and validates email addresses using MX records, SMTP RCPT probing, and catch-all detection.

4. Outreach Emails and Compliance

Outreach emails support personalized generation with DeepSeek and multilingual templates (English/Spanish/Portuguese). The system enables the dry-run master switch by default, and cold-start emails require manual approval. It supports Spintax variants, reply thread headers, unsubscribe disclaimer lines, and three-tier daily send limits (global / per mailbox / warm-up pool). Before sending, it runs an SPF/DKIM/DMARC/MX deliverability health check.

5. Reply Detection and Follow-up

It scans buyer replies via IMAP. Regex filtering is applied first, and AI is invoked only for ambiguous replies. The AI classifies replies into 12 categories (for example: inquiry, rejection, referral), automatically updates CRM status, and stops the follow-up sequence. Unsubscribed customers are automatically added to the suppression list, and fully bouncing domains are blacklisted.

6. CRM Pipeline and SOP

The CRM pipeline includes state-machine management (New → Assessment → Outreach → Quotation → Closed Won / Lost). The SOP stage machine enforces a mandatory eight-stage sequence and includes manual approval gates to ensure process compliance.

7. WhatsApp and Quotation

It integrates WhatsApp capabilities, supporting media message sending and controlled bulk sending (random intervals, daily caps, and a circuit breaker after 3 consecutive failures). It provides dependency-free English quotation PDF generation and can automatically link quotations to CRM customer profiles.

8. Tracking, Monitoring, and Warm-up

  • Tracking: requires a public endpoint to enable open/click tracking (pixel injection, link wrapping, and open-redirect protection).
  • Monitoring: periodically monitors website changes and intent signals to trigger automated outreach.
  • Warm-up pool: supports mutual warm-up across multiple mailboxes, independent ramp-up limits, and automatic recovery if messages land in spam.

9. Integration and Analytics

  • Direct Instantly integration: supports OpenAPI v2, allowing lead push and activity list retrieval.
  • Performance analytics: provides funnel conversion, segmented reply rates, market distribution, and open rate/click rate data.

Typical Use Cases

  1. Set the profile: icp_set (define what you sell and which buyers to find).
  2. Full customer acquisition flow: sop_create -> lead_search -> lead_enrich -> lead_score -> email_compose -> [manual approval] -> email_send.
  3. Quotation and outreach: kb_search (retrieve quotation policy) -> quote_pdf -> wa_send_media / email_send.

Notes

  • Security: All API keys and mailbox passwords are stored locally only; Webhooks must include a token. Tracking requires a public endpoint (such as Cloudflare Tunnel or a reverse proxy).
  • Compliance: When using the plugin, comply with search engine terms of service, CAN-SPAM/GDPR email marketing regulations, and WhatsApp terms of service.
  • Permissions and dependencies: The plugin runs within the DSH process; pay attention to the configuration of third-party gateways such as the Evolution API.