Property Shared

UK property data in one package. Pulls Land Registry sales, EPC certificates, Rightmove listings, rental yields, stamp duty calculations, planning portal links, and Companies House records.

Use it as a Python library, CLI, HTTP API, or MCP server.

What You Get

Data Source	What It Returns
Land Registry PPD	Sold prices, dates, property types, area comps with median/percentiles
EPC Register	Energy ratings, floor area, construction age, heating costs
Rightmove	Current listings (sale + rent), prices, agents, listing details
Yield Analysis	Gross yield from PPD sales + Rightmove rentals combined
Stamp Duty	SDLT calculation with April 2025 bands, BTL surcharge, FTB relief
Block Analyzer	Groups flat sales by building to spot investor exits
Planning	Local council planning portal lookup (99 verified councils, stdio only)
Companies House	Company search and lookup by name or number

Skills & Plugins

Property and Legal packs coming soon. Please get in contact if you have working experiance or expert knowledge in UK property investing, UK Estate Agents, Property and Conveyencing and would like to help shape this. paul@bouch.dev

Use as MCP Server

No install required — paste the URL into your MCP client config and go.

Claude Code, Cursor, any MCP client:

{
  "mcpServers": {
    "property-shared": {
      "type": "http",
      "url": "https://property-shared.fly.dev/mcp"
    }
  }
}

Install

pip install property-shared

# or with uv
uv add property-shared

Extras: [cli] for CLI, [api] for HTTP server, [dev] for tests.

pip install property-shared[cli]
# or
uv add property-shared --extra cli

Use as a Python Library

from property_core import PPDService, calculate_yield, calculate_stamp_duty

# Get comparable sales for a postcode
comps = PPDService().comps("SW1A 1AA", months=24, property_type="F")
print(f"Median flat price: {comps.median:,}")

# Calculate rental yield
import asyncio
result = asyncio.run(calculate_yield("NG1 1AA", property_type="F"))
print(f"Gross yield: {result.gross_yield_pct}%")

# Stamp duty
sdlt = calculate_stamp_duty(250000, additional_property=True)
print(f"SDLT: {sdlt.total_sdlt:,.0f} ({sdlt.effective_rate}%)")

All models are available at top level:

from property_core import (
    PPDTransaction, PPDCompsResponse, EPCData,
    RightmoveListing, RightmoveListingDetail,
    PropertyReport, YieldAnalysis, RentalAnalysis,
    BlockAnalysisResponse, CompanyRecord, StampDutyResult,
)

Interpretation helpers (core returns numbers, you decide how to label them):

from property_core import classify_yield, classify_data_quality, generate_insights

Use as CLI

pip install property-shared[cli]  # or: uv add property-shared --extra cli

# Comparable sales
property-cli ppd comps "SW1A 1AA" --months 24 --property-type F

# Rental yield
property-cli analysis yield "NG1 1AA" --property-type F

# Stamp duty
property-cli calc stamp-duty 300000

# Rightmove search (with sort)
property-cli rightmove search-url "NG1 1AA" --sort-by most_reduced

# Full property report
property-cli report generate "10 Downing Street, SW1A 2AA" --property-type F

Add --api-url http://localhost:8000 to any command to route through the HTTP API instead of calling core directly.

Use as HTTP API

pip install property-shared[api]  # or: uv add property-shared --extra api
property-api  # starts on port 8000

Interactive docs at http://localhost:8000/docs.

Key endpoints:

GET /v1/ppd/comps?postcode=SW1A+1AA&property_type=F&enrich_epc=true
GET /v1/analysis/yield?postcode=NG1+1AA&property_type=F
GET /v1/analysis/rental?postcode=NG1+1AA&purchase_price=200000
GET /v1/rightmove/search-url?postcode=NG1+1AA&sort_by=newest
GET /v1/calculators/stamp-duty?price=300000&additional_property=true
POST /v1/property/report with { "address": "10 Downing Street, SW1A 2AA" }

Full endpoint list in USER_GUIDE.md.

Environment Variables

Copy .env.example to .env. Key variables:

Variable	Required For	Description
`EPC_API_EMAIL`	EPC lookups	Free key from EPC Register
`EPC_API_KEY`	EPC lookups	Paired with email above
`COMPANIES_HOUSE_API_KEY`	Company search	Free key from Companies House
`RIGHTMOVE_DELAY_SECONDS`	No (default 0.6s)	Rate limit delay for Rightmove scraping
`OPENAI_API_KEY`	Planning scraper	Vision-guided planning portal scraper

Land Registry PPD and Rightmove work without credentials.

Development

# Install with dev extras
uv sync --extra dev

# Run API with reload
uv run uvicorn app.main:app --reload

# Run tests (mocked, no network)
uv run --extra dev pytest -v

# Run live integration tests (real network calls)
RUN_LIVE_TESTS=1 uv run --extra dev pytest -v

Deployed at https://property-shared.fly.dev with API docs at /docs and MCP endpoint at /mcp.

Release files for property-shared 1.13.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for property-shared 1.13.0
File	Size	Uploaded
property_shared-1.13.0.tar.gz	772.8 kB	Aug 24, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for property-shared 1.13.0
File	Interpreter	ABI	Platform	Reset
property_shared-1.13.0-py3-none-any.whl 167.8 kB Aug 24, 2026	Python 3	none	any	Details

Total release size: 940.6 kB

Release files / property_shared-1.13.0.tar.gz

Download URL	property_shared-1.13.0.tar.gz
Size	772.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`098c2707c55ddff52c294f0fd4eff3ff2a0bf8c9d28ff954729c09f466c6c83f`
BLAKE2b-256 checksum How to use checksums	`cf0f366931e013077b2a9fdbc51f0fa52043adf41079f74b8fa99e13ed002d45`
Upload date	Aug 24, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/paulieb89/property-shared
Publishing commit: github.com/paulieb89/property-shared/tree/2912e07c2460b1a879426a96dbbd442cf5a01252

Workflow

Publishing configuration: github.com/paulieb89/property-shared/blob/2912e07c2460b1a879426a96dbbd442cf5a01252/.github/workflows/release.yml
Publishing logs: github.com/paulieb89/property-shared/actions/runs/32756944223/attempts/1

Artifact

Subject: property_shared-1.13.0.tar.gz
SHA-256 checksum: 098c2707c55ddff52c294f0fd4eff3ff2a0bf8c9d28ff954729c09f466c6c83f Verifying attestations

Release files / property_shared-1.13.0-py3-none-any.whl

Download URL	property_shared-1.13.0-py3-none-any.whl
Size	167.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`54f0e08f1f7676666273085228e78f80af8c46648bbc34b60ec7452ac09e4fc1`
BLAKE2b-256 checksum How to use checksums	`b78fb52ab2e8656ce1f980d649eae0140fd260358679bf05fa510fcbd3e5174c`
Upload date	Aug 24, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/paulieb89/property-shared
Publishing commit: github.com/paulieb89/property-shared/tree/2912e07c2460b1a879426a96dbbd442cf5a01252

Workflow

Publishing configuration: github.com/paulieb89/property-shared/blob/2912e07c2460b1a879426a96dbbd442cf5a01252/.github/workflows/release.yml
Publishing logs: github.com/paulieb89/property-shared/actions/runs/32756944223/attempts/1

Artifact

Subject: property_shared-1.13.0-py3-none-any.whl
SHA-256 checksum: 54f0e08f1f7676666273085228e78f80af8c46648bbc34b60ec7452ac09e4fc1 Verifying attestations