indonesia-civic-stack

Quick Start

import asyncio
from civic_stack.bpom.scraper import search as bpom_search
from civic_stack.bmkg.scraper import get_latest_earthquake

async def main():
    # Search BPOM products
    results = await bpom_search("paracetamol")
    for r in results:
        print(r.result if r.found else r.status)

    # Latest earthquake
    eq = await get_latest_earthquake()
    print(eq.result)

asyncio.run(main())

Available Modules

Response Envelope

Every function returns CivicStackResponse:

response.found      # bool — was a record found?
response.status     # ACTIVE | EXPIRED | SUSPENDED | REVOKED | NOT_FOUND | ERROR
response.result     # dict — the normalized data (module-specific schema)
response.module     # str — which module produced this
response.source_url # str — the portal URL queried

MCP Tools (40 total)

Each module exposes MCP tools via FastMCP:

# Run a module's MCP server
python -m civic_stack.bpom.server      # stdio mode
python -m civic_stack.bmkg.server      # stdio mode

# Add to Claude Desktop
claude mcp add civic-bpom -- python -m civic_stack.bpom.server

Proxy (for non-Indonesian IPs)

# Indonesian VPS proxy (recommended — see references/vps-hardening.md)
export PROXY_URL="socks5h://127.0.0.1:1080"

# CF Worker proxy (limited — doesn't work for CF-protected portals)
export PROXY_URL="https://your-proxy.workers.dev"

See references/geo-restrictions.md for which portals need which proxy tier.

Operational References

Read these before debugging portal issues:

Dependencies

pip install httpx beautifulsoup4 pydantic lxml fastmcp
# For browser-based modules (bpjph, ahu, oss_nib):
pip install playwright && playwright install chromium