# SERP Title Width

> SERP Title Width is an open-source MCP server for web search and scraping. Check whether Chinese, Japanese and Korean page titles fit Google by pixel width. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, self-hosted
- **Website:** https://adsandcode.com/en/open-source/serp-title-width/
- **Repository:** https://github.com/adsandcode/serp-title-width
- **MCP Registry name:** io.github.adsandcode/serp-title-width
- **Categories:** web search and scraping, marketing and SEO, developer tools
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Firecrawl MCP Server](https://ai-powered.com/mcp/firecrawl-mcp-server): Firecrawl MCP Server is a freemium MCP server for web search and scraping.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/serp-title-width
