# Datacommons Client

Work with Data Commons, a platform providing programmatic access to public statistical...

- Repository: https://github.com/foryourhealth111-pixel/Vibe-Skills (3789 stars)
- Category: Engineering
- License: Unknown
- Last updated: 2026-10-31
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add foryourhealth111-pixel/Vibe-Skills --skill datacommons-client -g -a claude-code -y`
Codex: `npx skills add foryourhealth111-pixel/Vibe-Skills --skill datacommons-client -g -a codex -y`
Cursor: `npx skills add foryourhealth111-pixel/Vibe-Skills --skill datacommons-client -g -a cursor -y`
Gemini CLI: `npx skills add foryourhealth111-pixel/Vibe-Skills --skill datacommons-client -g -a gemini-cli -y`

## Description

Work with Data Commons, a platform providing programmatic access to public statistical data from global sources. Use this skill when working with demographic data, economic indicators, health statistics, environmental data, or any public datasets available through Data Commons. Applicable for querying population statistics, GDP figures, unemployment rates, disease prevalence, geographic entity resolution, and exploring relationships between statistical entities.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Data Commons Client

## Overview

Provides comprehensive access to the Data Commons Python API v2 for querying statistical observations, exploring the knowledge graph, and resolving entity identifiers. Data Commons aggregates data from census bureaus, health organizations, environmental agencies, and other authoritative sources into a unified knowledge graph.

## Routing Boundary

Use this skill when the user explicitly asks for Data Commons/datacommons, Data Commons statistical variables, Data Commons entities/DCIDs, or population/economic indicators that fit the Data Commons knowledge graph.

Generic public data, open data, public dataset search, or public download-link collection by itself is not enough to select this skill. Those requests need a clearer Data Commons/statistical-graph signal before this skill becomes the route owner.

## Installation

Install the Data Commons Python client with Pandas support:

```bash
uv pip install "datacommons-client[Pandas]"
```

For basic usage without Pandas:
```bash
uv pip install datacommons-client
```

## Core Capabilities

The Data Commons API consists of three main endpoints, each detailed in dedicated reference files:

### 1. Observation Endpoint - Statistical Data Queries

Query time-series statistical data for entities. See `references/observation.md` for comprehensive documentation.

**Primary use cases:**
- Retrieve population, economic, health, or environmental statistics
- Access historical time-series data for trend analysis
- Query data for hierarchies (all counties in a state, all countries in a region)
- Compare statistics across multiple entities
- Filter by data source for consistency

**Common patterns:**
```python
from datacommons_client import DataCommonsClient

client = DataCommonsClient()

# Get latest population data
response = client.observation.fetch(
    variable_dcids=["Count_Person"],
    entity_dcids=["geoId/06"],  # California
    date="latest"
)

The rest: https://github.com/foryourhealth111-pixel/Vibe-Skills/blob/HEAD/bundled/skills/datacommons-client/SKILL.md