TR Customs Trade Flow Fetcher

Collects Turkey's HS-code-based foreign trade data into a single standard schema. It uses TÜİK, TİM, UN Comtrade, and ITC Trade Map together as sources; for the HS codes, year range, and partner countries you provide, it fetches export/import rows.

Each row carries these fixed keys: year, HS code and its description, flow direction (export/import), partner country and ISO code, quantity (tons), value (USD), computed unit price (USD/ton), and the data source + update date. This way the rows can be fed directly into table, pivot, or time-series analysis.

When to use: When you want to measure a product group's (aluminum, steel, textile, food, pharmaceuticals, etc.) Turkey trade volume; derive market size and partner concentration; scan for import substitution / export opportunities; compare value-add via unit price (USD/ton); or build a trend across years.

Output: A JSON array of consistently keyed rows (year × HS × country × volume × value). The output contains no schema gaps; source attribution and update date are kept on every row, so source cross-checking is possible.

It is a read-only data fetcher; it produces no analysis or commentary — the analysis agent that calls it (e.g. the aluminum business-model hub) does that.