pyproc 0.2__tar.gz → 0.3__tar.gz

{pyproc-0.2 → pyproc-0.3}/.github/workflows/pyproc-pypi.yml

@@ -9,13 +9,33 @@ on:
       - v*
 
 jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v5
+
+    - name: Set up Python
+      uses: actions/setup-python@v6
+      with:
+        python-version: '3.x'
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        python -m pip install -e ".[test]"
+
+    - name: Run unit tests
+      run: |
+        python -m pytest tests/test_lpse_unit.py tests/test_cli_unit.py tests/test_cache.py -v
+
   release-build:
     runs-on: ubuntu-latest
+    needs: test
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v5
 
     - name: Set up Python
-      uses: actions/setup-python@v5
+      uses: actions/setup-python@v6
       with:
         python-version: '3.x'
 
@@ -31,7 +51,7 @@ jobs:
         python -m build
 
     - name: Upload distributions
-      uses: actions/upload-artifact@v4
+      uses: actions/upload-artifact@v5
       with:
         name: release-dists
         path: dist/
@@ -48,7 +68,7 @@ jobs:
 
     steps:
     - name: Retrieve release distributions
-      uses: actions/download-artifact@v4
+      uses: actions/download-artifact@v5
       with:
         name: release-dists
         path: dist/

pyproc-0.3/.github/workflows/test.yml

@@ -0,0 +1,32 @@
+name: Test
+
+on:
+  push:
+    branches: [master]
+    tags: [v*]
+  pull_request:
+    branches: [master]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ['3.9', '3.10', '3.11', '3.12', '3.13']
+
+    steps:
+    - uses: actions/checkout@v5
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v6
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        python -m pip install -e ".[test]"
+
+    - name: Run unit tests
+      run: |
+        python -m pytest tests/test_lpse_unit.py tests/test_cli_unit.py tests/test_cache.py -v

pyproc-0.3/PKG-INFO

@@ -0,0 +1,592 @@
+Metadata-Version: 2.4
+Name: pyproc
+Version: 0.3
+Summary: MCP tools for real-time Indonesian public procurement data from SPSE/Inaproc
+Project-URL: Homepage, https://github.com/wakataw/pyproc
+Project-URL: Issues, https://github.com/wakataw/pyproc/issues
+Author-email: Agung Pratama <workwithagung@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai-agent,inaproc,indonesia,llm,lpse,mcp,procurement,spse
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Natural Language :: Indonesian
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content :: CGI Tools/Libraries
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Requires-Dist: backoff
+Requires-Dist: beautifulsoup4
+Requires-Dist: html5lib
+Requires-Dist: requests
+Provides-Extra: mcp
+Requires-Dist: mcp; extra == 'mcp'
+Provides-Extra: test
+Requires-Dist: pytest; extra == 'test'
+Description-Content-Type: text/markdown
+
+# PyProc MCP
+
+<p align="center">
+  <img src="docs/assets/logo.png"
+       alt="PyProc MCP — Real-time Indonesian procurement data for LLM agents"
+       width="200">
+</p>
+
+<p align="center">
+  <strong>Real-time Indonesian procurement data for LLM agents</strong>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/pyproc/"><img src="https://img.shields.io/badge/version-v0.3-blue" alt="PyPI version"></a>
+  <a href="https://pypi.org/project/pyproc/"><img src="https://img.shields.io/badge/python-≥3.9-yellow" alt="Python ≥3.9"></a>
+  <a href="https://github.com/wakataw/pyproc/actions/workflows/test.yml?query=branch%3Amaster"><img src="https://github.com/wakataw/pyproc/actions/workflows/test.yml/badge.svg?branch=master" alt="Test Status"></a>
+  <a href="https://github.com/wakataw/pyproc/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="License: MIT"></a>
+  <a href="https://modelcontextprotocol.io"><img src="https://img.shields.io/badge/MCP-compatible-purple" alt="MCP Compatible"></a>
+</p>
+
+---
+
+PyProc MCP turns public **SPSE/Inaproc** procurement data into **MCP tools** that can be used by LLM clients (Claude Desktop, Continue, Cursor), AI agents, automation workflows, Python scripts, and command-line users.
+
+## Why PyProc MCP?
+
+<p align="center">
+  <img src="docs/assets/pyproc-mcp-banner.png"
+       alt="PyProc MCP — Real-time Indonesian procurement data for LLM agents"
+       width="800">
+</p>
+
+Indonesia's public procurement system (SPSE/Inaproc) processes thousands of tender and non-tender packages across hundreds of government institutions (LPSE). This data is public — but not easily accessible to AI agents and automation tools.
+
+PyProc MCP bridges this gap:
+
+- **LLM-native access** — MCP tools let AI agents search and analyze procurement data directly
+- **Real-time data** — Fetches live data from SPSE/Inaproc, not stale snapshots
+- **Comprehensive** — Full package details: announcements, participants, evaluation results, winners, schedules
+- **Lightweight** — Single command: `pyproc-mcp`. Works with any MCP-compatible client
+- **Multi-interface** — Use as MCP server, Python library, or CLI tool — same codebase, no lock-in
+- **Respectful defaults** — Built-in rate limiting, caching guidance, and responsible-use policy
+
+## What You Can Do
+
+- **Discover opportunities** — Search tender and non-tender packages across any LPSE host
+- **Deep-dive analysis** — Retrieve full package details: requirements, HPS value, location, schedule
+- **Competitive intelligence** — See who's bidding, who's winning, and at what price
+- **Timeline tracking** — Monitor procurement schedules from announcement to contract
+- **Vendor research** — Find which companies win which types of contracts where
+- **AI-powered insights** — Let LLMs analyze procurement patterns, compare packages, and generate reports
+- **Export and automate** — Use the Python library or CLI to build automated procurement monitoring pipelines
+
+---
+
+## Usage Modes
+
+PyProc can be used in three ways. Choose the one that fits your workflow:
+
+### 1. 🧠 MCP Server for LLM Clients (Recommended)
+
+Give your LLM direct access to Indonesian procurement data through MCP tools.
+
+```bash
+pip install pyproc[mcp]
+pyproc-mcp
+```
+
+**MCP Client Configuration:**
+
+Add to your MCP client's configuration file (e.g., `claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "pyproc": {
+      "command": "pyproc-mcp",
+      "args": [],
+      "env": {
+        "PYPROC_TIMEOUT": "30"
+      }
+    }
+  }
+}
+```
+
+Restart your MCP client. PyProc tools will appear in the tool list.
+
+### 2. 📦 Python Library
+
+Use PyProc as a Python library for custom automation and data analysis.
+
+```python
+from pyproc import Lpse, JenisPengadaan
+from pyproc.lpse import By
+
+# Initialize client for a specific LPSE host
+lpse = Lpse('kemenkeu')
+
+# Search for tender packages
+packages = lpse.get_paket_tender(
+    start=0,
+    length=20,
+    search_keyword='mobil dinas',
+    tahun=2025,
+    kategori=JenisPengadaan.PENGADAAN_BARANG
+)
+print(packages['data'])
+
+# Get full detail of a package
+detail = lpse.detil_paket_tender('10080116000')
+detail.get_all_detil()
+print(detail.todict())
+
+# Get only the winner
+winners = detail.get_pemenang()
+print(winners)
+```
+
+See [Python Library Usage](#python-library-usage) for complete API documentation.
+
+### 3. ⌨️ CLI Tool
+
+Download procurement data in bulk from the command line.
+
+```bash
+# Download tender data from Kemenkeu LPSE, export as JSON
+pyproc kemenkeu --keyword "mobil dinas" --tahun-anggaran 2025 --output-format json
+
+# Download non-tender data from multiple LPSE hosts
+pyproc jakarta,sumbarprov --jenis-paket non_tender --tahun-anggaran 2025
+
+# Download pencatatan non-tender data. This is distinct from non_tender.
+pyproc nasional --jenis-paket pencatatan_non_tender --tahun-anggaran 2026
+
+# Download with custom output filename
+pyproc "kemenkeu;output_kemenkeu" --output-format csv --separator ";"
+```
+
+See [CLI Usage](#cli-usage) for the full argument reference.
+
+---
+
+## MCP Tools
+
+The MCP server exposes the following tools:
+
+| Tool | Description |
+|---|---|
+| `search_lpse_hosts` | Find LPSE host slugs from institution names such as "kementerian keuangan" |
+| `get_lpse_host_detail` | Confirm metadata and canonical URL for a known LPSE host slug |
+| `get_procurement_search_options` | Explain direct keyword search vs local full-text indexing |
+| `search_tender_packages` | Search tender procurement packages by one or more exact SPSE keywords |
+| `search_non_tender_packages` | Search non-tender packages by one or more exact SPSE keywords |
+| `search_pencatatan_non_tender_packages` | Search pencatatan non-tender packages, a distinct `/dt/nonspk` entity |
+| `search_swakelola_packages` | Search swakelola packages |
+| `search_pengadaan_darurat_packages` | Search pengadaan darurat packages |
+| `get_tender_detail` | Get full detail for a tender package — announcement, participants, evaluations, winner, schedule |
+| `get_non_tender_detail` | Get full detail for a non-tender package |
+| `get_pencatatan_non_tender_detail` | Get detail for a pencatatan non-tender package |
+| `get_swakelola_detail` | Get detail for a swakelola package |
+| `get_pengadaan_darurat_detail` | Get detail for a pengadaan darurat package |
+| `get_tender_details_bulk` | Get details for multiple tender packages in one tool call |
+| `get_non_tender_details_bulk` | Get details for multiple non-tender packages in one tool call |
+| `get_pencatatan_non_tender_details_bulk` | Get details for multiple pencatatan non-tender packages |
+| `get_swakelola_details_bulk` | Get details for multiple swakelola packages |
+| `get_pengadaan_darurat_details_bulk` | Get details for multiple pengadaan darurat packages |
+| `get_procurement_categories` | List supported procurement categories (no network call) |
+| `validate_lpse_host` | Check if an LPSE host is accessible |
+| `create_procurement_search_index` | Download a bounded package set into a local SQLite full-text index |
+| `search_procurement_index` | Search a local SQLite full-text index |
+| `list_procurement_indexes` | List local full-text indexes |
+| `delete_procurement_index` | Delete a local full-text index |
+
+Each tool includes LLM-friendly descriptions with parameter documentation, rate limit notes, and data source attribution.
+
+---
+
+## LPSE Host Discovery
+
+Users do not need to know LPSE host slugs in advance. When a user names an institution, the LLM should resolve the host first, then search procurement packages.
+
+There are two procurement executor scopes:
+
+- Agency-specific hosts, such as `kemenkeu`, `jakarta`, or `pu`.
+- The nationwide host `nasional`, used for national-wide/lintas instansi data and pencatatan nasional sources.
+
+If the user asks for national, nationwide, all-Indonesia, lintas instansi, or pencatatan nasional data, use `lpse_host="nasional"` directly.
+
+Host discovery uses the maintained Gist host metadata and the `newUrlPath` field for agency hosts. The `nasional` host is built in and does not depend on the Gist metadata. Legacy `oldUrl` values are ignored. Canonical URLs are always built as:
+
+```text
+https://spse.inaproc.id/{newUrlPath}
+```
+
+Example user request:
+
+> cari data lelang pengadaan laptop pada kementerian keuangan
+
+Expected MCP flow:
+
+1. Call `search_lpse_hosts` with `query="kementerian keuangan"`.
+2. Select the best returned `host`, usually `kemenkeu`.
+3. Call `search_tender_packages` with `lpse_host="kemenkeu"` and `keyword="laptop"`.
+
+If multiple host candidates look plausible, the LLM should ask the user to choose the intended LPSE before searching package data.
+
+---
+
+## Search Modes
+
+SPSE/Inaproc package search is keyword-based. PyProc MCP therefore exposes two search strategies:
+
+- **Direct keyword search**: fast and lightweight. Use `search_tender_packages` or `search_non_tender_packages` with `keyword` or `keywords`, for example `["laptop", "notebook", "komputer"]`. The MCP server runs bounded SPSE searches and merges duplicate package IDs.
+- **Local full-text search**: broader but slower. Use `create_procurement_search_index` only after the user agrees to download and index a bounded package set locally; the tool requires `confirm_download=true`. Then use `search_procurement_index` to search downloaded package details with SQLite FTS.
+
+The LLM should start with direct keyword search. If results are weak or the user asks for a broader full-text search, it should explain the tradeoff before creating a local index.
+
+---
+
+## Example LLM Workflows
+
+Here are examples of what you can ask an LLM when PyProc MCP tools are connected:
+
+**"Cari data lelang pengadaan laptop pada kementerian keuangan"**
+→ LLM uses `search_lpse_hosts` to resolve "kementerian keuangan" to `kemenkeu`, then calls `search_tender_packages` with keywords like `["laptop", "notebook", "komputer"]`.
+
+**"Kalau keyword biasa kurang lengkap, cari full text di detail paket"**
+→ LLM explains that local indexing downloads package details, then uses `create_procurement_search_index` followed by `search_procurement_index` if the user agrees.
+
+**"Find active procurement packages related to cybersecurity in 2025"**
+→ LLM uses `search_tender_packages` with keyword "keamanan siber" or "cybersecurity" across relevant LPSE hosts.
+
+**"Summarize tender package 10080116000 on kemenkeu — what's the HPS, who won, and when?"**
+→ LLM uses `get_tender_detail` to retrieve the full package and summarizes key fields.
+
+**"Ambil detail untuk 5 paket tender pertama dari hasil pencarian"**
+→ LLM uses `get_tender_details_bulk` with the selected package IDs instead of calling `get_tender_detail` repeatedly.
+
+**"Compare the top 5 infrastructure tenders on pu LPSE by HPS value"**
+→ LLM uses `search_tender_packages` with `kategori=PEKERJAAN_KONSTRUKSI`, sorts by HPS, and presents a comparison table.
+
+**"Generate a vendor research checklist for a company bidding on IT procurement"**
+→ LLM analyzes recent IT-related tenders and generates a checklist of requirements, certifications, and typical bid values.
+
+---
+
+## Installation
+
+### Stable release
+
+```bash
+pip install pyproc
+```
+
+### With MCP support
+
+```bash
+pip install pyproc[mcp]
+```
+
+### Development version
+
+```bash
+pip install git+https://github.com/wakataw/pyproc.git
+```
+
+### Uninstall
+
+```bash
+pip uninstall pyproc
+```
+
+---
+
+## Configuration
+
+The MCP server is configured via environment variables:
+
+| Variable | Default | Description |
+|---|---|---|
+| `PYPROC_TIMEOUT` | `30` | HTTP request timeout in seconds |
+| `PYPROC_RATE_LIMIT_DELAY` | `1.0` | Minimum seconds between requests |
+| `PYPROC_LOG_LEVEL` | `INFO` | Logging level (DEBUG, INFO, WARNING, ERROR, CRITICAL) |
+
+---
+
+## Cache and Rate Limiting
+
+- **MCP server**: Does not use persistent caching. Each tool call makes a fresh request to SPSE/Inaproc. Rate limiting enforces a minimum 1-second delay between requests to respect SPSE servers.
+- **CLI tool**: Uses a local SQLite database (`.idx` file) for download progress tracking and resume support. The cache is disposable per-download.
+- **Python library**: No built-in caching. You control the request lifecycle through the `Lpse` class methods.
+
+Data freshness depends on SPSE/Inaproc source availability. For the most up-to-date information, visit [spse.inaproc.id](https://spse.inaproc.id).
+
+---
+
+## Python Library Usage
+
+### Initialization
+
+```python
+from pyproc import Lpse
+
+lpse = Lpse('kemenkeu', timeout=30)  # timeout in seconds
+```
+
+The `Lpse` class supports context manager usage:
+
+```python
+with Lpse('kemenkeu') as lpse:
+    packages = lpse.get_paket_tender(length=10)
+```
+
+### Search Tender Packages
+
+```python
+from pyproc import Lpse, JenisPengadaan
+from pyproc.lpse import By
+
+lpse = Lpse('kemenkeu')
+
+# Basic search
+packages = lpse.get_paket_tender(start=0, length=25)
+
+# Search by keyword
+packages = lpse.get_paket_tender(search_keyword='sekolah', length=10)
+
+# Filter by category
+packages = lpse.get_paket_tender(
+    kategori=JenisPengadaan.PENGADAAN_BARANG,
+    length=10
+)
+
+# Filter by budget year
+packages = lpse.get_paket_tender(tahun=2025, length=10)
+
+# Sort by HPS
+packages = lpse.get_paket_tender(order=By.HPS, length=10)
+
+# Raw data only (list instead of dict)
+data = lpse.get_paket_tender(data_only=True, length=10)
+```
+
+### Search Non-Tender Packages
+
+```python
+packages = lpse.get_paket_non_tender(start=0, length=25)
+```
+
+### Search Pencatatan Packages
+
+Pencatatan non-tender is a separate entity from ordinary non-tender.
+
+```python
+packages = lpse.get_paket_pencatatan_non_tender(
+    kategori=JenisPengadaan.JASA_LAINNYA,
+    rekanan='PT Test',
+    tahun=2026,
+    instansi_id='L112',
+)
+
+swakelola = lpse.get_paket_swakelola(
+    tipe_swakelola=1,
+    rekanan='Direktorat Arsitektur dan Desain',
+    tahun=2026,
+    instansi_id='K68',
+)
+
+darurat = lpse.get_paket_pengadaan_darurat(
+    kategori=JenisPengadaan.PEKERJAAN_KONSTRUKSI,
+    tahun=2026,
+    instansi_id='D267',
+)
+```
+
+### Get Package Detail
+
+```python
+# Get all detail sections
+detail = lpse.detil_paket_tender('10080116000')
+detail.get_all_detil()
+
+# Access individual sections
+detail.get_pengumuman()       # Announcement
+detail.get_peserta()          # Participants
+detail.get_hasil_evaluasi()   # Evaluation results
+detail.get_pemenang()         # Winner
+detail.get_pemenang_berkontrak()  # Contracted winner
+detail.get_jadwal()           # Schedule
+
+# Serialize to dict
+data = detail.todict()
+```
+
+### Non-Tender Detail
+
+```python
+detail = lpse.detil_paket_non_tender('10080116000')
+detail.get_all_detil()
+```
+
+### Pencatatan Detail
+
+```python
+detail = lpse.detil_paket_pencatatan_non_tender('10942236000')
+detail.get_all_detil()
+
+swakelola = lpse.detil_paket_swakelola('10336514000')
+swakelola.get_all_detil()
+
+darurat = lpse.detil_paket_pengadaan_darurat('106802')
+darurat.get_all_detil()
+```
+
+### Procurement Categories
+
+```python
+from pyproc import JenisPengadaan
+
+# List all categories
+for cat in JenisPengadaan:
+    print(cat.name, cat.value)
+
+# Use as filter
+JenisPengadaan.PENGADAAN_BARANG           # Goods Procurement
+JenisPengadaan.PEKERJAAN_KONSTRUKSI       # Construction Works
+JenisPengadaan.JASA_LAINNYA               # Other Services
+# ... and more
+```
+
+---
+
+## CLI Usage
+
+### Basic Download
+
+```bash
+pyproc kemenkeu
+```
+
+This downloads tender data from the Kemenkeu LPSE and exports it as `kemenkeu.csv`.
+
+### Arguments
+
+| Argument | Example | Default | Description |
+|---|---|---|---|
+| `lpse_host` | `pyproc kemenkeu` | Required | LPSE host or text file with host list |
+| `-k, --keyword` | `--keyword "mobil dinas"` | `""` | Search keyword filter |
+| `-t, --tahun-anggaran` | `--tahun-anggaran 2025` | Current year | Budget year (single, comma-separated, or range) |
+| `--kategori` | `--kategori PEKERJAAN_KONSTRUKSI` | None | Procurement category |
+| `--jenis-paket` | `--jenis-paket pencatatan_non_tender` | `tender` | One of `tender`, `non_tender`, `pencatatan_non_tender`, `swakelola`, `darurat` |
+| `--rekanan` | `--rekanan "PT MAJU"` | None | Provider/rekanan name filter |
+| `--instansi-id` | `--instansi-id K68` | None | K/L/PD code from master KLPD |
+| `--tipe-swakelola-id` | `--tipe-swakelola-id 1` | None | Swakelola-only type filter |
+| `-c, --chunk-size` | `--chunk-size 50` | `100` | Records per page |
+| `-x, --timeout` | `--timeout 60` | `30` | Request timeout (seconds) |
+| `-d, --index-download-delay` | `--index-download-delay 5` | `1` | Delay between index pages (seconds) |
+| `-o, --output-format` | `--output-format json` | `csv` | Output format: `csv` or `json` |
+| `--keep-index` | `--keep-index` | `False` | Keep SQLite index file after download |
+| `-r, --resume` | `--resume` | `False` | Resume failed download |
+| `-s, --separator` | `--separator "|"` | `;` | CSV delimiter |
+| `--log` | `--log DEBUG` | `INFO` | Log level |
+
+### Multi-Host Download
+
+```bash
+# Download from multiple LPSE hosts
+pyproc jakarta,kemenkeu,sumbarprov
+
+# With custom output filenames
+pyproc "jakarta;file_jakarta,kemenkeu;file_kemenkeu"
+```
+
+### Download Host List
+
+```bash
+# Export LPSE host list as CSV from Gist metadata
+pyproc daftarlpse
+
+# Export LPSE host list as sanitized Gist-backed JSON
+pyproc daftarhost
+```
+
+---
+
+## Responsible Use and Disclaimer
+
+**This project is not affiliated with LKPP, LPSE, SPSE, Inaproc, or any Indonesian government institution.**
+
+PyProc MCP accesses publicly available procurement data from SPSE/Inaproc systems. Users are responsible for:
+
+- **Respectful usage** — Do not overwhelm SPSE servers with excessive requests. The tool includes built-in rate limiting.
+- **Data accuracy** — Procurement data may be incomplete, delayed, or changed by source systems. LLM-generated analysis should be verified against official sources at [spse.inaproc.id](https://spse.inaproc.id).
+- **Compliance** — Ensure your use complies with applicable laws and regulations in Indonesia.
+- **No disruption** — Do not use this tool to disrupt public e-procurement services.
+
+### Bahasa Indonesia
+
+> Penulis tidak terafiliasi dengan pengembang SPSE atau pemilik aplikasi SPSE. Software ini dikembangkan dengan tujuan akademis, bentuk pengawasan oleh masyarakat, dan membantu pengusaha untuk mempermudah otomasi perolehan informasi pengadaan dari pemerintah.
+>
+> Penggunaan yang tidak wajar dan mengganggu sebagian atau seluruh fungsi aplikasi SPSE pada satuan kerja menjadi tanggung jawab masing-masing pengguna.
+>
+> PyProc ada karena SPSE ada, jadi gunakanlah dengan bijak dan secukupnya.
+
+---
+
+## Development
+
+```bash
+# Clone the repository
+git clone https://github.com/wakataw/pyproc.git
+cd pyproc
+
+# Install with dev dependencies
+pip install -e ".[test]"
+pip install -e ".[mcp]"  # for MCP development
+
+# Run tests
+python -m pytest tests/ -v
+
+# Run unit tests only (no network required)
+python -m pytest tests/ --ignore=tests/test_lpse.py --ignore=tests/test_downloader.py -v
+```
+
+### Project Structure
+
+```
+pyproc/
+    __init__.py          # Public API: Lpse, JenisPengadaan
+    lpse.py              # API wrapper + HTML parsers
+    cli.py               # CLI downloader pipeline
+    cache.py             # SQLite cache store
+    utils.py             # Token parsing, host list
+    exceptions.py        # Exception classes
+    text.py              # UI strings
+    mcp/                 # MCP server adapter layer
+        server.py        # MCP server entry point
+        tools.py         # Tool handlers
+        schemas.py       # Validation and normalization
+        resources.py     # MCP resources
+        errors.py        # Error mapping
+```
+
+---
+
+## License
+
+MIT License. See [LICENSE](LICENSE) for details.
+
+---
+
+## Donatur ☕️
+
+Orang-orang yang berjasa menyediakan kopi sehingga pengembangan paket tetap berjalan:
+
+- Angga Rinaldi Rizal (50 cangkir ☕️)