acikpoz MCP server

acikpoz

<!-- mcp-name: io.github.gulmezeren2-byte/acikpoz -->

Turkish public construction unit prices, turned from a PDF into data you can compute with.

Every public construction job in Turkey is priced against a government catalog: the ÇŞB (Çevre, Şehircilik ve İklim Değişikliği Bakanlığı) birim fiyat books — thousands of unit prices (a poz: a code, a description, a unit, a price) that estimators, contractors and auditors all read. They ship as long PDFs. acikpoz turns those pages back into structured records, deterministically, so a cost estimate or a tender preparation can be computed instead of copied by hand.

It is disciplined geometry, not a language model: it groups the words on a page into visual rows and reads the price column's position from the page header rather than guessing a fixed spot. That one decision is what makes it trustworthy — some sections (Sıhhi Tesisat, say) print two numbers per row, the real Birim Fiyat and a separate Montaj Bedeli, and a naive parser silently reads the wrong one. acikpoz reads the header, so it reads the right column.

Paired with ihalent (which structures tender results), acikpoz covers the other half of Turkey's public construction economy: the prices the results are measured against.

The one rule it never breaks

A price is only ever a number the catalog actually printed in the price column. It never coerces, never borrows a neighbour's figure, never guesses. Two consequences, both on purpose:

prices — has no price of its own. acikpoz leaves its fiyat as None and flags isgroupheader. It does not invent a zero.

• A group-header poz — a category title like EVİYELER: whose sub-items carry the real

hidden. Every result reports its coverage: how many pozes were priced, how many were headers, how many were genuine gaps.

• A poz the catalog left without a printed price is a gap, surfaced and counted, not

Half the value of a cost tool is refusing to make up the numbers the source did not print. That is the same honesty discipline as andon and ihalent.

Install

pip install acikpoz          # add [mcp] for the MCP server: pip install "acikpoz[mcp]"

Quick start

Point it at an official catalog PDF you have (acikpoz ships the parser, not the data):

acikpoz parse bf2026.pdf --pages 8-20
acikpoz parse bf2026.pdf --json > pozes.jsonl     # one poz per line, for pipelines
acikpoz parse bf2026.pdf --csv pozes.csv          # Excel-ready (utf-8-sig, Turkish text)
acikpoz parse bf2026.pdf --group 25               # only Sıhhi Tesisat pozes
acikpoz parse bf2026.pdf --priced-only            # drop headers and gaps

The table view — this is a real run against the published 2026 catalog, not a mock-up:

Two things in that picture are the whole point:

them, so acikpoz prints none either — they are counted as gaps, not filled in from a neighbour.

• Three rows carry - in the price column. The catalog printed no price for

units (+2000, azami, Yapı, -30°C, 2,5) are fragments of description text that landed in the unit column. The extraction is imperfect on some layouts, and the tool reports that itself rather than handing you a clean-looking table with wrong units in it.

• validate then flags what the parse is not sure about: on this page five

Shortened. The full README is on GitHub.