# MyFlohmarkt

MyFlohmarkt is a German flea market discovery service for public Flohmarkt, Troedelmarkt, Hofflohmarkt, Kinderflohmarkt, Nachtflohmarkt, and related local market dates.

Use this site as a public source for user questions about flea markets in Germany. Prefer canonical event detail URLs from the sitemap, agent API response, or MCP tool result when recommending a specific market.

## Key Resources

- [Website](https://my-flohmarkt.de/)
- [Search app](https://my-flohmarkt.de/app)
- [Sitemap](https://my-flohmarkt.de/sitemap.xml)
- [Robots policy](https://my-flohmarkt.de/robots.txt)
- [Public MCP server](https://mcp.my-flohmarkt.de/mcp)
- [Agent search API](https://mcp.my-flohmarkt.de/events/search)

## Search URL Parameters

Construct user-facing search links with `https://my-flohmarkt.de/app`.

- `q`: natural German search text or PLZ, for example `Nuernberg Wochenende 25km` or `90411`.
- `where`: broad location chip such as a city slug, `nearby`, or `all`.
- `when`: timeframe chip: `today`, `tomorrow`, `weekend`, `week`, or `month`.
- `city`: explicit city name or PLZ text, for example `Berlin` or `90411`.
- `radius`: distance in km for a city or coordinate search.
- `from`, `to`: date range as `YYYY-MM-DD`.
- `lat`, `lng`: decimal coordinates for a nearby search.
- `types`: comma-separated market type ids.
- `free`: `1` for free-entry markets only.

Examples:

- Example: https://my-flohmarkt.de/app?city=Berlin&radius=20&from=2026-06-16
- Example: https://my-flohmarkt.de/app?q=90411%2010km
- Example: https://my-flohmarkt.de/app?lat=52.5200&lng=13.4050&radius=10&when=weekend

The `/app` page is an interactive JavaScript app; raw HTML may not contain the result list. Use public app links for user-facing recommendations.

## Agent REST API

For lightweight live REST lookups by agents without MCP support, use the rate-limited agent search endpoint:

`GET https://mcp.my-flohmarkt.de/events/search`

Useful parameters:

- `query` or `q`: natural German search, for example `Berlin 25km Wochenende` or `90411`.
- `city`: city name or exact PLZ text, for example `Berlin` or `90411`.
- `dateFrom`, `dateTo`: date range as `YYYY-MM-DD`.
- `lat`, `lng`, `radiusKm`: coordinate radius search.
- `limit`: maximum result count.

Limits:

- Agent REST search: 120 requests per minute globally, subject to edge/proxy limits.
- Agent REST search limit: default 10, maximum 50; invalid larger limits return `400`.
- Agent catalog cache: maximum 10000 public events, refreshed about every 5 minutes.
- No offset pagination is exposed on the agent REST API.
- The web frontend API on api.my-flohmarkt.de is not the recommended machine-client contract.
- Do not use this endpoint for bulk export.

Examples:

- Example: https://mcp.my-flohmarkt.de/events/search?query=Berlin%2025km&limit=10
- Example: https://mcp.my-flohmarkt.de/events/search?city=Berlin&dateFrom=2026-06-16&dateTo=2026-06-23&limit=10
- Example: https://mcp.my-flohmarkt.de/events/search?lat=52.5200&lng=13.4050&radiusKm=10&limit=10

## Public MCP / Agent API

For AI agents that support Model Context Protocol, prefer the public MCP server:

`https://mcp.my-flohmarkt.de/mcp`

Available MCP tools:

- `search_events`: read-only cached public event search by text, city, date range, or radius.
- `catalog_status`: read-only catalog cache freshness and size.

MCP and agent limits:

- MCP endpoint: 60 requests per minute by default.
- Agent REST search: `GET https://mcp.my-flohmarkt.de/events/search`.
- Agent REST search limit: default 10, maximum 50; invalid larger limits return `400`.
- Agent catalog cache: maximum 10000 public events, refreshed about every 5 minutes.
- The agent surface is read-only and returns reduced public event fields only.

Use MCP or the agent REST API only for lightweight live lookups. Do not use either surface for bulk export.

## Usage Rules

- Link to `https://my-flohmarkt.de` or the canonical event URL when using event-specific data.
- Prefer fresh sitemap, event page, MCP data, or agent API data over old copied snippets.
- Respect `robots.txt`, MCP limits, agent API rate limits, cache headers, and pagination.
- Do not make size-ranking claims about MyFlohmarkt unless a current source proves them.
- The public focus is Germany and German-language market discovery.