Skip to content
MCP server

SERP Title Width

Check whether Chinese, Japanese and Korean page titles fit Google by pixel width

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, API, self-hosted
Runs
Locally
Version
0.1.0
Listing updated
2 days ago

About SERP Title Width

SERP Title Width is an open-source MCP server for web search and scraping. It runs locally on your machine and is started by your AI client.

Character counts come from Latin text, so a 60-character limit lets through CJK titles that Google cuts in half. This tool measures rendered width against a model taken from google.com on 2026-09-18 with the zh-TW interface in Chrome on Windows: Arial 22px titles in a 652px desktop column. A full-width character is 22px, and ASCII letters use Arial's real advance widths.

Results fall into tiers. Up to 572px is safe, over 572px warns, over 630px fails as an edge case, and over 648px fails as truncated. An all-CJK title crosses the truncation line at its 30th character. Other checks flag more than two 、 or , separators, more than one full-width question mark, the same trailing phrase on more than two titles, a first mobile line over 343px, repeated keyword runs and empty titles.

It runs as a CLI for builds and CI, where the exit code is the contract, and as an MCP server so an assistant can measure a title as it writes. It needs no API key or network, and the server refuses to start if its self-test fails. The author notes the model covers one setting only, and Japanese and Korean reuse the full-width assumption without separate measurement.

Install

Run in a terminal

claude mcp add serp-title-width -- npx -y mcp-server-serp-title-width

Add to claude_desktop_config.json

{
  "mcpServers": {
    "serp-title-width": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-serp-title-width"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "serp-title-width": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-serp-title-width"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "serp-title-width": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-serp-title-width"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "serp-title-width": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-serp-title-width"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "serp-title-width": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-serp-title-width"
      ]
    }
  }
}

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

measure_titles
Measures a list of title strings against the pixel-width model
check_title_files
Reads the title of local HTML files or directories and checks it

What it does

Pixel-width measurement
Scores titles by rendered width instead of character count.
Tiered verdicts
Safe, long, edge and cut tiers with fail at 630px and 648px.
Site-wide scan
Scans a built directory so repeated boilerplate tails are caught.
CI exit codes
0 pass, 1 fix needed, 2 the ruler failed its own controls.
Offline and keyless
No API key or network access, Node.js 18 or later.
Self-test on start
The server refuses to run if its own positive and negative controls fail.

Good for

  • Gate a deploy on CJK title lengths
  • Let an assistant measure a title while drafting it
  • Audit all titles in a built static site
  • Find duplicated title suffixes across pages

Pricing

Open source

MIT licensed, free

Prices change. Check adsandcode.com before you buy.

SERP Title Width FAQ

What tools does the MCP server expose?

Two read-only tools: measure_titles for a list of strings and check_title_files for local HTML files or directories.

Which licence?

MIT.

How accurate is it for Japanese and Korean?

The model was measured only on google.com with a Traditional Chinese interface; Japanese and Korean use the same full-width assumption and were not measured separately.

Does it call Google?

No. It needs no network access or API key.

Is SERP Title Width free?

Yes. SERP Title Width is open source, so you can use and self-host it for free.

How do I add SERP Title Width to Claude Code?

Run this command in your terminal: claude mcp add serp-title-width -- npx -y mcp-server-serp-title-width

What are the best alternatives to SERP Title Width?

The closest alternatives to SERP Title Width are REA, Scrapling MCP Server, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.

Alternatives to SERP Title Width

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. MCP server for AI clients to scrape sites with HTTP and stealth browser sessions

    Runs locally
    • 17 tools
    • Open source
    • 104K GitHub stars
    • Web search and scraping
  3. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  4. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  5. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  6. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory