Kleinanzeigen

kleinanzeigen-mcp

kleinanzeigen.de（ドイツのクラシファイドサイト）を対象とする、読み取り専用で robots に準拠した MCP サーバーです。

---

できること

ツール	内容	リクエスト数
search_listings	検索クエリに一致する掲載情報の1ページ分を取得します。	1
get_listing	広告 ID を指定して、1件の掲載情報をすべて取得します。	1
get_shop	1つの事業者のプロフィールと掲載情報を取得します。	1
find_category	名前に一致するカテゴリ ID を検索します。	0 — データセットに同梱
find_location	名前に一致する場所 ID を検索します。	0 — データセットに同梱
find_shop	名前に一致する事業者のショップスラッグを検索します。	1

---

インストール

Node 22 以降が必要です。4つの方法で同じリリースから同じビルドをインストールできます。異なるのは取得を行う対象だけで、相互に情報が伝播することはありません。

方法	対象	コマンド
npm / npx — 推奨	MCP クライアントを使うすべてのユーザー	npx -y kanzeigen-mcp
Claude Code	1行で設定、JSON 不要	claude mcp add kleinanzeigen -- npx -y kanzeigen-mcp
Claude Desktop	JSON の編集が一切不要	リリースから .mcpb をダウンロードして開きます
Claude Code plugin	サーバーとスキルをまとめて利用	/plugin marketplace add IIxauII/kleinanzeigen-mcp
クローンから実行	開発用	開発

npm / npx — 任意の MCP クライアント

パッケージ名は kanzeigen-mcp です。

インストール手順もビルドも不要です。クライアントで npx を指定すれば、初回実行時にパッケージが取得されます。

{
  "mcpServers": {
    "kleinanzeigen": {
      "command": "npx",
      "args": ["-y", "kanzeigen-mcp"]
    }
  }
}

このブロックをクライアントの設定ファイルに記述します。Claude Desktop では claude_desktop_config.json、Claude Code では .mcp.json、それ以外ではそれぞれに相当するファイルを使用します。その後、クライアントを再起動してください。

クライアントを使わずに手動で動作を確認するには、次のようにします。

npx -y kanzeigen-mcp

Claude Code

claude mcp add kleinanzeigen -- npx -y kanzeigen-mcp

環境変数の割り当ては -- の前に記述してください。 -- 以降はすべて Claude Code が実行するコマンドです。そのため、変数をここに記述すると環境変数ではなく npx の引数になります。

claude mcp add kleinanzeigen -e KLEINANZEIGEN_MCP_RATE_LIMIT_MS=3000 -- npx -y kanzeigen-mcp

Claude Desktop — MCPB

最新リリースから kanzeigen-mcp-<version>.mcpb をダウンロードして開きます。Claude Desktop がインストールし、以下の設定項目をフォームで表示するため、設定ファイルは必要ありません。

選ぶ前に知っておきたい点が2つあります。このバンドルは署名されていない状態で配布されるため、インストールダイアログに警告が表示されます。自己署名では独自の検証に失敗し、有効な証明書は誰も購入していないからです。また、この形式には更新機能がありません。インストール済みの .mcpb はダウンロードした時点のままで、更新を促す通知が表示されることもありません。

Claude Code plugin — サーバーとスキル

/plugin marketplace add IIxauII/kleinanzeigen-mcp
/plugin install kanzeigen@kanzeigen

---

設定

KLEINANZEIGEN_MCP_RATE_LIMIT_MS — リクエスト間に設ける最小間隔（ミリ秒）。

• 未設定の場合は 1500 ms です。

{
  "mcpServers": {
    "kleinanzeigen": {
      "command": "npx",
      "args": ["-y", "kanzeigen-mcp"],
      "env": { "KLEINANZEIGEN_MCP_RATE_LIMIT_MS": "3000" }
    }
  }
}

---

開発

クローンから実行します。これは開発用の手順であり、インストール方法ではありません。ドリフトチェックとフィクスチャ取得スクリプトを実行できるツリーが得られるのは、この方法だけです。

git clone [email protected]:IIxauII/kleinanzeigen-mcp.git
cd kleinanzeigen-mcp
npm install
npm run build

npm run build を実行すると、単一ファイルの ESM バンドル dist/index.js と、隣接する 2 つのサイドカーデータセットが生成されます。絶対パスを指定してクライアントから接続します。

{
  "mcpServers": {
    "kleinanzeigen": {
      "command": "node",
      "args": ["/absolute/path/to/kleinanzeigen-mcp/dist/index.js"]
    }
  }
}

npm test           # the whole suite
npm run typecheck  # tsc --noEmit, which is the real typecheck
npm run build      # tsup, into dist/

パーサーテストは、コミット済みのフィクスチャに対して実行されます。フィクスチャは開発時スクリプトで別途手動取得し、サーバーが取得することはありません。パーサーが実際に読み取る DOM に最小化し、個人情報を削除します。削除ルールの対象は、取得したマークアップに含まれる個人情報や特定につながる情報すべてであり、パーサーが読み取らない属性も含みます。パーサーが参照するフィールドだけを対象にした処理では、以前、追跡属性にパートナー広告の ID やショップ名が残ってしまいました。このルールをテストで固定しています。

2 つのバンドル済みデータセットの再生成、ドリフトチェックの実行、リリースの作成に関するメンテナー向けの手順は、docs/maintenance.md にあります。この手順は、インストールした人ではなく、クローンを手元に持つ人を対象としているためです。

詳しくは、完全な仕様については SPEC.md、コードベースで使われているすべての名前の用語については CONTEXT.md、この方針の背景にある決定については docs/adr/ を参照してください。