Hatena Bookmark Weekly/Monthly Ranking MCP Server

An MCP server that provides Hatena Bookmark weekly and monthly ranking data. Contains data from 2023-2024 (full years) and 2025 (January to June, with weekly data through June 2nd week and monthly data through May).

🛠️ Available Tools

weekly - Weekly Ranking Retrieval

Description: Retrieve weekly Hatena bookmark rankings (30 entries) for a specified week

Parameters:

• year (integer, required): Year (2023-2025)
• month (integer, required): Month (2023-2024: 1-12, 2025: 1-6)
• week (integer, required): Week number (1-5, week 5 only exists in some months)

monthly - Monthly Ranking Retrieval

Description: Retrieve monthly Hatena bookmark rankings (50 entries) for a specified month

Parameters:

• year (integer, required): Year (2023-2025)
• month (integer, required): Month (2023-2024: 1-12, 2025: 1-5, June data will be available after month end)

Installation

Using uv (Recommended)

No special installation is required when using uv. You can run mcp-server-hatena-weekly directly using uvx.

Using PIP

Alternatively, you can install mcp-server-hatena-weekly using pip:

pip install mcp-server-hatena-weekly

After installation, you can run the script as follows:

mcp-server-hatena-weekly

Configuration

Configure for Claude.app

Add to your Claude settings:

{
  "mcpServers": {
    "hatena-weekly": {
      "command": "uvx",
      "args": ["mcp-server-hatena-weekly"]
    }
  }
}

Configure for VS Code

For quick installation, use one of the one-click install buttons below...

Command Line Options

You can specify the following options when running the server:

• --sse: Enable Server-Sent Events transport (on/off)
• --host: Server bind address (default: localhost)
• --port: Server port number (default: 8000)
• --log-level: Logging verbosity (debug, info, warning, error)

📄 License

MIT License