io.github.IIxauIIPublished by GitHub account IIxauIIv1.1.0Updated Oct 31, 2026
A read-only, robots-clean MCP server over kleinanzeigen.de
Read-only MCP server for kleinanzeigen.de, the German classifieds site, letting an assistant search listings, open ads and look up commercial shops.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Follow the launch instructions in the repository.
A read-only, robots-clean MCP server over kleinanzeigen.de, the German classifieds site.
Node 22 or newer is required. Four channels install the same build from the same release — they differ only in who does the fetching, and nothing propagates between them.
The package is kanzeigen-mcp.
There is no install step and nothing to build. Point your client at npx and let it fetch the package on first run:
That block goes in your client's config file — claude_desktop_config.json for Claude Desktop, .mcp.json for Claude Code, the equivalent for anything else. Restart the client afterwards.
To verify by hand, without a client:
Any environment assignment goes before the --. Everything after the -- is the command Claude Code runs, so a variable placed there becomes an argument to npx rather than an environment variable:
Download kanzeigen-mcp-<version>.mcpb from the latest release and open it. Claude Desktop installs it and offers the one knob below as a form field, so nothing here needs a config file.
Two things are worth knowing before you pick it. The bundle ships unsigned, so the install dialog warns — self-signing fails its own verification, and a real certificate is a purchase nobody has made. And the format has no update mechanism: an installed .mcpb is as current as the day it was downloaded, and nothing will ever prompt you.
KLEINANZEIGEN_MCP_RATE_LIMIT_MS — the minimum gap between requests, in milliseconds.
Run from a clone. This is the development path rather than an install channel — it is the only one that yields a tree the drift check and the fixture-capture scripts can run in.
npm run build produces a single-file ESM bundle at dist/index.js plus two sidecar datasets beside it. Point a client at it by absolute path:
Parser tests run against committed fixtures: hand-captured out of band by a dev-time script — never by the server — minimised to the DOM the parser actually reads, and redacted. The redaction rule is everything personal or identifying in the captured markup, including attributes the parser never reads: a pass aimed only at the fields the parser touches is how partner-ad ids and shop names once survived in tracking attributes. A test pins the rule.
Maintainer procedure — regenerating the two bundled datasets, running the drift check, and cutting a release — lives in docs/maintenance.md, because it addresses someone standing in a clone rather than someone who installed this.
Further reading: SPEC.md for the full contract, CONTEXT.md for the vocabulary every name in the codebase uses, and docs/adr/ for the decisions behind the posture.
Source: README.md at commit 18fe2b0
Search listings
One page of listings matching a search query. Promoted listings repeat on every page; high-volume queries drift between pages, so a listing can be missed or seen twice across a walk.
pagesortradiusad_typebuy_nowkeywordslocationshippingmax_pricemin_pricecategory_idlocation_id+2 moreGet listing
One listing in full, by ad id.
ad_idrequiredGet shop page and inventory
Profile and listings for one COMMERCIAL seller. Private sellers have no shop page and cannot be reached by this server.
pagekeywordsmax_pricemin_priceshop_slugrequiredcategory_idlocation_idFind categories
Category ids matching a name. Always returns candidates — names and slugs collide, so only the numeric id identifies a category.
queryrequiredFind locations
Location ids matching a name or postcode. Always returns candidates — a postcode can map to several locations.
queryrequiredFind shops
Shop slugs for COMMERCIAL sellers matching a name. Makes a live request, unlike the other resolvers. A match may be a mention in a shop's profile text rather than its name, so check before using one.
namerequiredpagecategory_idlocation_id90% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
{ "mcpServers": { "kleinanzeigen": { "command": "npx", "args": ["-y", "kanzeigen-mcp"] } }}npx -y kanzeigen-mcpclaude mcp add kleinanzeigen -- npx -y kanzeigen-mcpclaude mcp add kleinanzeigen -e KLEINANZEIGEN_MCP_RATE_LIMIT_MS=3000 -- npx -y kanzeigen-mcp/plugin marketplace add IIxauII/kleinanzeigen-mcp/plugin install kanzeigen@kanzeigen{ "mcpServers": { "kleinanzeigen": { "command": "npx", "args": ["-y", "kanzeigen-mcp"], "env": { "KLEINANZEIGEN_MCP_RATE_LIMIT_MS": "3000" } } }}git clone [email protected]:IIxauII/kleinanzeigen-mcp.gitcd kleinanzeigen-mcpnpm installnpm run build{ "mcpServers": { "kleinanzeigen": { "command": "node", "args": ["/absolute/path/to/kleinanzeigen-mcp/dist/index.js"] } }}npm test # the whole suitenpm run typecheck # tsc --noEmit, which is the real typechecknpm run build # tsup, into dist/