publishers-mcp

MCP server for discovering book, manga, BD, comics, and webtoon publisher contacts. Two-phase pipeline: scrape publisher directories, then extract contact information from individual publisher websites.

Install

npx publishers-mcp

MCP Configuration

Claude Desktop / Claude Code

{
  "mcpServers": {
    "publishers": {
      "command": "npx",
      "args": ["-y", "publishers-mcp"]
    }
  }
}

Local Development

{
  "mcpServers": {
    "publishers": {
      "command": "node",
      "args": ["/path/to/publishers-mcp/dist/server.js"]
    }
  }
}

MCP Tools

| Tool | Description | |------|-------------| | scrape_source | Scrape publishers from a specific directory source | | scrape_all_sources | Scrape all registered directory sources | | extract_contacts | Visit publisher websites and extract contacts | | search_publishers | Search/filter publishers with pagination | | update_publisher | Update publisher record fields | | update_contact | Update contact record fields | | delete_publisher | Delete publisher and cascaded contacts | | delete_contact | Delete a contact record | | export_data | Export to JSON or CSV |

MCP Resources

| Resource | URI | |----------|-----| | Publisher details | publisher://{id} | | Publisher contacts | publisher://{id}/contacts | | Available sources | source://list | | Scrape run history | scrape-run://list |

MCP Prompts

| Prompt | Description | |--------|-------------| | publisher_outreach | Generate outreach email draft for a publisher | | publisher_summary | Summarize all known info about a publisher |

CLI

Also usable as a CLI for direct operations:

npx publishers-mcp cli scrape comics-org --max 50
npx publishers-mcp cli scrape
npx publishers-mcp cli extract --limit 20
npx publishers-mcp cli search --query "marvel" --country US
npx publishers-mcp cli list-sources

Sources

| Source | Status | Method | |--------|--------|--------| | comics.org (GCD) | Implemented | REST API | | animenewsnetwork.com | Implemented | HTML | | mangaupdates.com | Implemented | HTML | | bedetheque.com | Stub | HTML | | bdgest.com | Stub | HTML | | icv2.com | Stub | HTML | | acbd.fr | Stub | HTML | | jbpa.or.jp | Stub | HTML | | frankfurtbookfair.com | Stub | HTML | | webtoons.com | Stub | HTML |

Development

npm install
npm run build
npm run check        # build + lint + format + test
npm run test         # vitest
npm run dev          # tsc --watch

Environment Variables

| Variable | Default | Description | |----------|---------|-------------| | PUBLISHER_SCRAPER_DB_PATH | publisher-scraper.db | SQLite database path | | PROXY_URL | none | Proxy URL for HTTP requests |