linkth-crawl-mcp

LINKTH CRAWL MCP Server

linkth-crawl-mcp lets MCP clients call the hosted LINKTH CRAWL SEO crawler API over stdio.

The server is a thin client. It does not bundle secrets, does not connect to your database, and only calls the public hosted API with your per-user uck_live_ API key.

Requirements

• Node.js 18 or newer
• A LINKTH CRAWL API key from the app dashboard
• Hosted API base URL: https://crawler.link-th.co.jp

Usage

LINKTH_API_KEY=uck_live_xxx npx -y linkth-crawl-mcp

Optional:

LINKTH_API_BASE=https://crawler.link-th.co.jp

Backward-compatible environment variables are still accepted:

• LINKSCRAWL_API_KEY
• LINKSCRAWL_API_BASE

New integrations should use LINKTH_API_KEY and LINKTH_API_BASE.

MCP Client Config

.mcp.json example:

{
  "mcpServers": {
    "linkth-crawl": {
      "command": "npx",
      "args": ["-y", "linkth-crawl-mcp"],
      "env": {
        "LINKTH_API_KEY": "uck_live_xxx",
        "LINKTH_API_BASE": "https://crawler.link-th.co.jp"
      }
    }
  }
}

Supported Tools

These tools are exposed by the public MCP server:

Tool	Purpose
list_jobs	List your crawl jobs.
crawl_site	Start a crawl.
crawl_status	Check crawl progress.
list_pages	List crawled pages.
get_links	Inspect internal link edges.
orphans	Find orphan pages.
structure_summary	Summarize site structure.
page_detail	Inspect one crawled page.
find_similar	Find similar pages.
pagerank	Return PageRank scores.
issues	Return detected SEO issues.

extract is a paid/admin-only hosted API feature and is intentionally excluded from the public beta MCP tool list. generate_proposals is intentionally not exposed in this package because the hosted endpoint currently returns 501 until behavior-data tenant mapping is wired.

Development

npm install
npm run build
npm test
npm run typecheck

Run locally:

LINKTH_API_KEY=uck_live_xxx LINKTH_API_BASE=https://crawler.link-th.co.jp node dist/index.js

Publish

The package is prepared for public npm publishing, but publishing must be done by the package owner:

npm login
npm publish --access public