designmark

io.github.xecin-incPublished by GitHub account xecin-incv1.0.0Updated Oct 25, 2026

Search and fetch Japanese landing-page design systems (DESIGN.md) from designmark.jp.

Overview

AI-generated overview

Searches designmark.jp for Japanese landing-page design systems and returns DESIGN.md files an assistant can save into a project and build with.

What you can do
Search designs and pattern packs by keyword, industry, mood, main color and view, with one line of results per item (ID, title, industry, moods, colors, page URL). Fetch the full DESIGN.md of a single landing-page analysis by ID or designmark.jp URL. List pattern packs by industry with their ID, title and number of source designs. Fetch the full DESIGN.md of a pattern pack, including its license and an attribution example. The server never writes files; the assistant saves the returned DESIGN.md itself.
When to use it
Useful when you want an AI coding assistant to build a page in a specific Japanese landing-page style and need concrete color, typography, spacing and component tokens to work from. Also suited to picking a synthesized pattern pack for an industry and mood instead of a single page analysis.
Requirements
Runs locally over stdio, typically via npx with Node.js 20 or later; no account, API key or header is declared. Needs network access to designmark.jp. Optional environment variables set language (DESIGNMARK_LANG), cache folder (DESIGNMARK_CACHE_DIR) and API base URL (DESIGNMARK_API).
Before you install
Fetches are rate-limited: at most 3 designs per request, 30 per 10 minutes, at least 1 second apart, and bulk downloading is prohibited by the site's terms. Landing-page analyses are unofficial and must not reuse the original logos, photos, copy or product names. Pattern packs are CC BY 4.0 and require attribution. Requests go to designmark.jp, which may log IP addresses.

Installation

In SourceWeft

  1. Open designmark in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

designmark

Japanese landing-page design systems (DESIGN.md) for AI coding agents — search designmark.jp and drop one into your project from the terminal, any MCP client, or Claude Code.

日本語 · designmark.jp · Pattern packs on GitHub

designmark.jp publishes DESIGN.md files analysed from more than 4,000 public Japanese landing pages — colors, typography, spacing, components and section structure — plus CC BY 4.0 pattern packs synthesised per industry and mood. Hand one to Claude Code, Cursor or another AI coding tool and it builds pages in that look.

bash
npx designmark search 化粧品 --mood elegantnpx designmark add <ID> --claude-md

add saves DESIGN.md in the current folder; --claude-md also adds the line @DESIGN.md to CLAUDE.md so that Claude Code reads it. Requires Node.js 20 or later.

CLI

CommandWhat it does
search [words...]Search LP designs and pattern packs. Every word must match.
show <ID>Title, style, industry, moods, colors (role and HEX) and page URL. --raw prints the whole DESIGN.md.
add <ID...>Save up to 3 designs: DESIGN.md for one, design/<ID>.md for two or three.
packsList the pattern packs by industry.
open <ID>Open the design's page on designmark.jp.
mcpStart the MCP server (stdio).

IDs are xd-xxxxxxxx (LP design), pk-… (pattern pack) or a designmark.jp URL. Every command accepts --json, --lang ja|en and --help. Output is plain text (no colors).

search option
--category <name|slug>Industry, e.g. cosmetics or 化粧品
--mood <name|slug>Mood, repeatable (all must match): natural soft elegant minimal pop retro cute sporty cool dark-luxury trust handmade wafu fresh bold dense
--color <family>Main color: red orange yellow green teal blue purple pink brown black gray white, or a Japanese name such as 青 (LP designs only)
--view sp|pcAnalysed view (LP designs only)
--packs-only / --lp-onlyOnly pattern packs / only LP designs
--limit <1-50>Number of results (default 10; up to 3 pattern packs come first)
add option
--dir <folder>Project folder (default: the current folder)
--out <file>File to write, for a single ID (default DESIGN.md)
--forceOverwrite existing files (never overwritten otherwise)
--claude-mdAdd @<written file> to CLAUDE.md (only once, however often you run it)
bash
npx designmark search クリニック --view sp --limit 5npx designmark search --category cosmetics --mood elegant --mood soft --jsonnpx designmark packs --category cosmeticsnpx designmark show pk-cosmetics-elegantnpx designmark add pk-cosmetics-elegant --claude-mdnpx designmark add <ID> --out docs/DESIGN.md

To save a design to a file, use add (with --out for another path) rather than redirecting show --raw: add writes the bytes unchanged, while Windows PowerShell 5.1 re-encodes redirected output.

Exit codeMeaning
0Success
1Failure (a file could not be written, or an unexpected network error)
2Usage error (unknown option, invalid ID, more than 3 IDs, …)
3Not found: the design is not in the latest index (withdrawn, or a wrong ID)
4Temporarily unavailable (access may be limited): wait about 5 minutes
Environment variable
DESIGNMARK_LANGja or en (--lang takes precedence). Without either: LC_ALL / LC_MESSAGES / LANG, then the system locale
DESIGNMARK_CACHE_DIRIndex cache folder. Default: %LOCALAPPDATA%\designmark on Windows, otherwise $XDG_CACHE_HOME/designmark or ~/.cache/designmark
DESIGNMARK_APIBase URL of the API (default https://designmark.jp; for testing)
BROWSER=noneopen prints the URL instead of opening a browser

MCP server

Claude Code:

bash
claude mcp add designmark -- npx -y designmark@1 mcp

Cursor (.cursor/mcp.json):

json
{ "mcpServers": { "designmark": { "command": "npx", "args": ["-y", "designmark@1", "mcp"] } } }

designmark@1 keeps you on major version 1. If your MCP client cannot start npx on native Windows, use cmd with the arguments /c npx -y designmark@1 mcp.

ToolInputReturns
search_designsquery, category, moods, color, view, include_packs (default true), limit (1–20, default 10)One line per design: ID, title, industry, moods, main colors, page URL
get_designid (xd-… or URL)A usage notice, a blank line, then the full DESIGN.md
list_packscategoryOne line per pattern pack: ID, title, number of source designs
get_packid (pk-… or URL)The license and an attribution example, a blank line, then the full DESIGN.md

The server never writes files; your agent saves the DESIGN.md. Messages follow DESIGNMARK_LANG (or the system locale).

Claude Code plugin

text
/plugin marketplace add xecin-inc/designmark/plugin install designmark@designmark

The plugin bundles the designmark skill — ask Claude Code for a Japanese-style landing page and it picks an industry and mood, shows you up to 3 candidates, adds the one you choose and builds with its tokens — and the MCP server above.

Rate limits — and why

designmark's terms of use (Article 2, paragraph 3) prohibit automated bulk fetching. This tool is built to stay well inside that:

  • add fetches at most 3 designs per run, one at a time, at least 1 second apart. There is no bulk-download command.
  • The MCP server fetches at most 30 designs per 10 minutes per process, at least 1 second apart, and stops fetching for 5 minutes after designmark.jp refuses a request.
  • Search reads one index file, cached for 6 hours and then revalidated with ETag. DESIGN.md files are never cached, so a withdrawn design disappears quickly.
  • A withdrawn design ends with exit code 3. Exit code 4 means designmark.jp may be limiting your access: wait about 5 minutes, and do not retry other IDs in a loop.

Please keep these limits if you fork the tool, and do not mirror designmark.jp or redistribute its LP designs as a dataset. Clients without the limits may be blocked.

About the data

  • LP designs (xd-…) are unofficial analyses of public Japanese landing pages; designmark is not affiliated with the companies behind them. Never reuse the logos, photos, copy or product names of the original pages — use your own materials.
  • Pattern packs (pk-…) are synthesised from many designs and describe no single page. They are licensed CC BY 4.0; attribution example: "designmark (XECIN Inc.)". Browse them on designmark.jp or in the pattern pack collection.
  • Rights holders of an original page can request removal through the takedown form.

Privacy

No telemetry. The tool talks only to https://designmark.jp, with a designmark-cli/<version> or designmark-mcp/<version> User-Agent. As with any website, designmark.jp may log the IP addresses of requests.

Development

bash
npm cinpm run lintnpm run typechecknpm test     # a local fixture server stands in for designmark.jpnpm run build

Releases are published to npm by GitHub Actions when a v* tag is pushed (trusted publishing with provenance).

designmark is made by XECIN Inc. For help building landing pages with AI or a DESIGN.md of your own, see consultation.

Issues and pull requests are welcome — see CONTRIBUTING.md. Please report security problems privately as described in SECURITY.md. Changes are listed in CHANGELOG.md.

License

The code in this repository is licensed under the MIT License © 2026 XECIN Inc. The designs on designmark.jp are governed by designmark's terms of use; pattern packs are CC BY 4.0.

Source: README.md at commit d717805

Tools

4

search_designs

Search Japanese LP designs

Search designmark.jp for DESIGN.md design systems of Japanese landing pages (LP): unofficial analyses of public Japanese LPs (colors, typography, spacing, components, section structure), plus CC BY 4.0 pattern packs synthesised per industry and mood. Filter by keywords (Japanese or English), industry, mood, main color and view. Returns one line per design: ID | title | industry | moods | main colors | page URL. Then fetch the chosen design with get_design (xd-…) or get_pack (pk-…). Searching reads a cached index and does not count toward the fetch limit (30 DESIGN.md fetches per 10 minutes).

Parametersviewcolorlimitmoodsquerycategoryinclude_packs

get_design

Get a Japanese LP DESIGN.md

Fetch the full DESIGN.md of one Japanese landing-page design from designmark.jp by ID (xd-xxxxxxxx) or designmark.jp URL, to save as DESIGN.md in the project. Fetch at most 3 designs per user request; this server allows 30 fetches per 10 minutes, at least 1 second apart. The first line is a notice: these are unofficial analyses, so never reuse the original page's logos, photos, copy or product names.

Parametersidrequired

list_packs

List pattern packs

List designmark pattern packs (pk-…): CC BY 4.0 DESIGN.md files synthesised from many Japanese landing pages per industry and mood. One line per pack: ID | title | number of designs it was synthesised from. Does not count toward the fetch limit.

Parameterscategory

get_pack

Get a pattern pack DESIGN.md

Fetch the full DESIGN.md of a designmark pattern pack (pk-…) by ID or designmark.jp URL: a design system synthesised from many Japanese landing pages of one industry and mood. Pattern packs are CC BY 4.0 (attribution required); the first line shows the license and an attribution example. Counts toward the fetch limit (30 per 10 minutes, at least 1 second apart).

Parametersidrequired

Version history

1
  1. v1.0.0LatestOct 25, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts