wwv-plugin-opencorporates

WorldWideView Plugin — OpenCorporates Business Intelligence Layer

Search for companies using the OpenCorporates API and plot them on the WorldWideView 3D globe with full ownership, officer, and financial status data.

What it does

• Searches OpenCorporates for any company name you specify
• Geocodes each company's registered address via OpenStreetMap Nominatim
• Plots them as colored pins on the globe:
  • 🟢 Green = Active company
  • 🔴 Red = Dissolved / struck off / liquidated
  • 🟡 Yellow = Unknown status
• Click any pin to see: company number, jurisdiction, type, incorporation date, officers, registry URL
• Refreshes every 10 minutes
• Filter by jurisdiction (e.g. us_de for Delaware, gb for UK, eg for Egypt)

Use Cases

• Track shell company networks by jurisdiction
• Map corporate ownership structures geographically
• Research where companies in a financial crime investigation are registered
• Compare corporate density across jurisdictions
• Follow the money — see where holding companies cluster

Installation

Option 1: Via WorldWideView Marketplace (once published)

1. Open WorldWideView → click Submit a Plugin
2. Enter: wwv-plugin-opencorporates
3. Click Submit Plugin

Option 2: Manual / Local Dev

# 1. Clone / download this plugin
git clone https://your-repo/wwv-plugin-opencorporates
cd wwv-plugin-opencorporates

# 2. Install dependencies
npm install

# 3. Build
npm run build

# 4. Publish to npm (required for marketplace submission)
npm login
npm publish --access public

Configuration

After installing in WorldWideView, open the plugin settings panel and fill in:

| Field | Description | Example | |---|---|---| | API Key | Your OpenCorporates API key | abc123xyz | | Company Search Query | What to search for | Goldman Sachs | | Jurisdiction Filter | Limit by country/state (optional) | us_de or gb | | Max Results | How many companies to plot (1-100) | 50 |

Get a free OpenCorporates API key:

👉 https://opencorporates.com/api_accounts/new

Jurisdiction codes:

• us_de — Delaware USA
• us_ny — New York USA
• gb — United Kingdom
• eg — Egypt
• ae — UAE
• ky — Cayman Islands
• Leave blank for global search

How it works

User sets search query
        ↓
OpenCorporates API → returns company list
        ↓
Each company's address → Nominatim geocoder → lat/lon
        ↓
Globe entity emitted with color based on company status
        ↓
WorldWideView plots pin on 3D globe
        ↓
Click pin → popup shows full company data

License

MIT — build on it, modify it, do whatever.