Picoli MCP

🚀 picoli - mcp

picoli.site のMCPサーバー — AIエージェント向けのURL短縮とクリック分析機能を提供します。

AIアシスタントから直接URLを短縮し、クリックを追跡し、リンクのパフォーマンスを分析できます。

🚀 クイックスタート

🔍 1. APIキーの取得

picoli.site でアカウントを作成し、ダッシュボードからAPIキーを取得します。

⚙️ 2. MCPクライアントの設定

Claude Desktop / Claude Code

MCP設定に以下を追加します。

{
  "mcpServers": {
    "picoli": {
      "command": "npx",
      "args": ["-y", "picoli-mcp"],
      "env": {
        "PICOLI_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor

.cursor/mcp.json に以下を追加します。

{
  "mcpServers": {
    "picoli": {
      "command": "npx",
      "args": ["-y", "picoli-mcp"],
      "env": {
        "PICOLI_API_KEY": "your-api-key-here"
      }
    }
  }
}

✨ 主な機能

shorten_url

任意のカスタムスラッグを指定して短縮URLを作成します。

使用例:

• "Shorten https://example.com/very-long-article-url"
• "Create a short link for https://my-site.com with slug 'launch'"

shorten_urls

一度に複数（最大500個）の短縮URLを作成します。

使用例:

• "Shorten these 3 URLs: ..."

get_link_stats

特定のリンクのクリック統計を取得します（ボットトラフィックは除外）。

使用例:

• "How many clicks did my 'launch' link get?"
• "Show me stats for these slugs: launch, demo, blog - post"

list_links

クリック数とページネーション付きですべての短縮URLをリスト表示します。

使用例:

• "Show me all my short links"
• "List my links sorted by clicks"

get_analytics

分析概要を取得します：上位10のリンク、日別クリックトレンド、および合計数。

使用例:

• "Show me my link analytics for this week"
• "What are my top performing links?"
• "Give me click stats from 2026 - 01 - 01 to 2026 - 01 - 31"

📚 ドキュメント

環境変数

開発

git clone https://github.com/yun/picoli-mcp.git
cd picoli-mcp
npm install
npm run build

ローカルでテストするには：

PICOLI_API_KEY=your-key npx tsx src/index.ts

📄 ライセンス

MIT