메뉴
This skill should be used when reading or writing portal YAML profiles in portals/<portal>.yaml. Defines the canonical structure that scout-recon writes and scraper/query-builder reads. Reference before creating or validating any portal profile.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | Portal Profile Schema |
| description | This skill should be used when reading or writing portal YAML profiles in portals/<portal>.yaml. Defines the canonical structure that scout-recon writes and scraper/query-builder reads. Reference before creating or validating any portal profile. |
The canonical structure for portals/<portal>.yaml. scout-recon writes these. Scripts and agents read them. Bump schema_version if you change the shape.
schema_version: 1
portal: <slug> # kleinanzeigen, immoscout24, etc.
display_name: <human-readable>
base_url: https://...
last_verified: <YYYY-MM-DD>
revisions: <int>
legal:
preferred_access: [scrape|api|rss|email_alerts]
ban_risk: low|medium|high
rendering:
search_page: ssr|csr|hybrid_ssr|hybrid_csr
detail_page: ssr|csr|hybrid_ssr|hybrid_csr
strategy:
recommended_order: [readability|hydration_blob|jina|playwright_stealth|chrome]
query_grammar:
search_url_template: <string with {placeholders}>
district_map:
"<District Name>": <encoded value>
extraction:
detail:
primary_source: hydration_blob|jsonld|dom
fields:
cold_rent: {path: ..., format: ..., required: true, presence_rate: 0.0}
sqm: {path: ..., format: ..., required: false, presence_rate: 0.0}
rooms: {path: ..., format: ..., required: false, presence_rate: 0.0}
district: {path: ..., format: ..., required: true, presence_rate: 0.0}
listing_id: {path: ..., format: ..., required: true, presence_rate: 0.0}
posted_at: {path: ..., format: ..., required: false, presence_rate: 0.0}
expected_field_count: <int>
See portals/kleinanzeigen.yaml for a complete filled example. Key sections:
legal: robots_allows_listings, tos_automation, preferred_access, ban_risk, notesdiscovery: rss, api, email_alerts, sitemap, newest_first_param, update_frequency, poll_interval_srendering: page types, hydration_blob selector, jsonld_present, ajax_endpointsanti_bot: provider, cold_request_works, rate_limit_estimate_rpm, challenges_seenstrategy: recommended_order, tier_confidence (0-1 float per tier), per_tier_cooldown_squery_grammar: search_url_template, district_encoding, district_map, rent/sqm/rooms paramsextraction: search_results card selector + fields; detail primary_source + all fieldsquirks: array of {description, impact: blocking|annoying|informational, workaround}scam_signals: portal-specific patterns fed to scam-judgeevidence: directory path and file list| Format | Meaning | Example input | Parsed value |
|---|---|---|---|
eur_de | German euro string | "1.350 €" | 1350 |
sqm_de | German sqm string | "65 m²" | 65 |
float_de | German float | "2,5" | 2.5 |
url_last_segment | Last path segment | ".../789-101" | "789" |
de_date_relative | German relative date | "vor 2 Stunden" | requires fetched_at reference |
url_list | List of src attrs | multiple img tags | ["url1", "url2"] |
When changing the schema shape:
schema_versionrevision_notes entry with the change descriptionThis skill should be used when the user asks to "assess this flat", "assess this listing", "is this a good flat", "evaluate this apartment ad", or pastes a rental listing URL and wants a quality judgment beyond scam detection. Combines quantitative scores (fit, scam, Mietspiegel) with a qualitative Berlin-rental checklist and produces a structured assessment report.
This skill should be used when the user asks to "prepare an application", "prepare my Bewerbungsmappe", "what documents do I need for a flat application", or wants to apply for a Berlin rental after a viewing. Covers the standard Berlin application dossier, document freshness rules, and the applicant's legal rights (Selbstauskunft limits, Kaution cap, Abstandszahlung rules).
This skill should be used when making any decision about Berlin rental listings — pricing, legality, district quality, Mietspiegel. Provides Berlin 2024 rental law essentials and market context for scam detection, scoring, and messaging.
This skill should be used when drafting rental inquiry messages for Kristian. Captures his writing register so messages are authentic and not AI-flavored.
This skill should be used when constructing or debugging search URLs for Berlin rental portals. Documents the URL grammar for each supported portal so malformed queries don't silently return garbage.
This skill should be used when running scout-recon as the working checklist document. Provides the Layer A-E checklist for profiling a new portal or re-verifying an existing one.