# Daily Berlin Jobs: routine for AI agents

Use this file as the instructions for a scheduled AI agent, for example a task that runs every day at 08:00 Europe/Berlin. Base URL: https://daily-berlin-jobs.vercel.app

## Ask the user once and keep with the task

- Roles, e.g. Backend, Fullstack (allowed values: `filters.roles` in https://daily-berlin-jobs.vercel.app/api/v1/status)
- Levels, e.g. Junior / Entry, Senior
- Work mode: Remote, Hybrid, On-site, or any
- Must-have and nice-to-have skills, e.g. TypeScript, PostgreSQL
- Whether German-language roles are acceptable
- Deal-breakers, e.g. recruitment agencies, on-site only

## Daily routine

1. GET https://daily-berlin-jobs.vercel.app/api/v1/status and read `updated_at`.
   - If `updated_at` is not newer than the value you saved last time, the data has not been refreshed yet. Check again later; `next_expected_window` tells you when the next refresh is expected. If `stale` is true, tell the user the data may be out of date.
2. Get the jobs added since your last run:
   GET https://daily-berlin-jobs.vercel.app/api/v1/jobs?since=<saved updated_at>&role=<roles>&level=<levels>&work_mode=<mode>
   - On the very first run, use `latest=1` instead of `since`.
   - If `next_cursor` is not null, request the same URL with `cursor=<next_cursor>` until it is null.
3. Shortlist jobs whose title, role, level and tech_stack fit the profile. For each shortlisted job, GET its `detail_url` and read the description when `description_available` is true. Check language requirements, seniority and deal-breakers. If the description is not available, judge from the metadata and say so.
4. Report to the user: the best matches, each with title, company, why it fits, any concerns, and the apply link. If nothing fits, say so in one line. Only use information present in the data; do not invent salaries, visa sponsorship or requirements.
5. Save the `updated_at` value from step 1 and use it as `since` on the next run.

## Notes

- If your agent supports MCP, you can add https://daily-berlin-jobs.vercel.app/api/mcp as a remote MCP server instead of calling the HTTP API; the tools `get_status`, `search_jobs` and `get_job` cover the same routine.
- Free and read-only; no API key. Responses are cached and change about once a day, so keep each run to a handful of requests.
- Jobs are removed 30 days after posting.
- Prefer the apply link from the data; do not guess company career URLs.