boom-vitt/claude-thai-skills/thai-address

Thai Address (แยก/ตรวจที่อยู่ไทย)

Overview

แยกที่อยู่ไทย (บ้านเลขที่ หมู่ ซอย ถนน ตำบล/แขวง อำเภอ/เขต จังหวัด รหัสไปรษณีย์) เป็น structured dict, ตรวจ postcode 5 หลัก, ดูจังหวัดจาก 2 หลักแรกของ postcode, และ map ระหว่างชื่อไทย/อังกฤษของ 77 จังหวัด. รองรับชื่อถนนหลายคำ (เช่น ถนนพระราม 9, ถนนเลียบทางด่วน) และฟิลด์คอนโด/อพาร์ตเมนต์ (อาคาร, ชั้น, ห้อง) ด้วย.

When to use

• Parse ที่อยู่จากฟอร์ม, e-commerce, PDF
• ตรวจรหัสไปรษณีย์ก่อน submit
• แปลที่อยู่ไทย → English transliteration สำหรับฉลากพัสดุระหว่างประเทศ
• DO NOT use as a delivery-routing source of truth — postcode prefixes are many-to-one (Bangkok metro area shares prefix 10). For exact sub-district resolution, use a Thailand Post sub-district database.

Example prompts

• "แยกที่อยู่นี้ให้หน่อย: 123/45 ซอยสุขุมวิท 21 ถนนสุขุมวิท แขวงคลองเตยเหนือ เขตวัฒนา กรุงเทพ 10110"
• "รหัส 50200 อยู่จังหวัดอะไร"

Field ordering (สำคัญ!)

Thai postal addresses go small-to-large — the reverse of English convention. Always order fields like this on a shipping label:

[อาคาร → ชั้น → ห้อง →] บ้านเลขที่ → หมู่ → ซอย → ถนน → ตำบล/แขวง → อำเภอ/เขต → จังหวัด → รหัสไปรษณีย์

Example (house):

123/45 ซอยสุขุมวิท 21 ถนนสุขุมวิท
แขวงคลองเตยเหนือ เขตวัฒนา
กรุงเทพมหานคร 10110

Example (condo / apartment):

อาคารชาญอิสสระ ชั้น 12 ห้อง 1203
99 ถนนพระราม 4
แขวงสีลม เขตบางรัก
กรุงเทพมหานคร 10500

Bangkok vs provincial vocabulary

Never mix these. A Bangkok address must use แขวง/เขต; a provincial address must use ตำบล/อำเภอ. Mixing them is a strong "this address is wrong" signal.

Transliteration cheatsheet

Quick reference

parse_address return keys

house_no, moo, soi, road, building, floor, unit, subdistrict, district, province, postcode. Each is a str or None. building covers อาคาร / ตึก / คอนโด.

Multi-token road names are captured up to the next address keyword, so ถนนพระราม 9 แขวงห้วยขวาง … yields road = "พระราม 9". Thai numerals (๐-๙) and compound names (ถนนเลียบทางด่วน, ถนนสาทรเหนือ) are supported.

Postcode prefix map (selected)

Full 77-province table: `provinces.json`.

Implementation

• Python: `parse.py` — python parse.py runs self-tests
• TypeScript: `parse.ts` — npx tsx parse.ts runs self-tests

Common mistakes

• Field reversal. Writing Bangkok 10110 Wattana Khwaeng… in English order on a Thai-side label confuses postmen. Always small-to-large in Thai.
• Mixing แขวง with อำเภอ. Bangkok = แขวง/เขต. Everywhere else = ตำบล/อำเภอ. Never mix.
• Trusting postcode prefix alone. Prefix 10 spans Bangkok, Samut Prakan, parts of Nonthaburi and Pathum Thani. Use the full 5-digit code for routing.
• Dropping leading zeros from house numbers. 123/4 and 123/04 may differ; preserve as the user wrote them.
• Soi naming. Soi names are often the same as the parent road (ซอยสุขุมวิท 21 is off ถนนสุขุมวิท). Don't merge them or you'll lose the sub-numbering.