U.S. provisional weekly deaths from COVID-19, influenza and pneumonia

Copy into the console's Import or share a recipe panel to customize fields, types and schedules. This configuration contains no captured records or workspace IDs.

{
  "schema": "sourcefinch/source@1",
  "name": "U.S. provisional weekly deaths from COVID-19, influenza and pneumonia",
  "url": "https://data.cdc.gov/resource/r8kw-7aab.json?$select=week_ending_date,year,mmwr_week,total_deaths,covid_19_deaths,influenza_deaths,pneumonia_deaths,pneumonia_and_covid_19_deaths,pneumonia_influenza_or_covid_19_deaths,percent_of_expected_deaths,data_as_of&$where=state=%27United%20States%27%20AND%20week_ending_date%20IS%20NOT%20NULL&$order=week_ending_date%20DESC&$limit=52",
  "recipe": {
    "mode": "http",
    "format": "json",
    "items": "[*]",
    "fields": {
      "week": "week_ending_date",
      "mmwr_week": "mmwr_week",
      "mmwr_year": "year",
      "data_as_of": "data_as_of",
      "total_deaths": "total_deaths",
      "covid_19_deaths": "covid_19_deaths",
      "influenza_deaths": "influenza_deaths",
      "pneumonia_deaths": "pneumonia_deaths",
      "percent_of_expected_deaths": "percent_of_expected_deaths",
      "pneumonia_and_covid_19_deaths": "pneumonia_and_covid_19_deaths",
      "pneumonia_influenza_or_covid_19_deaths": "pneumonia_influenza_or_covid_19_deaths"
    },
    "required": [
      "week"
    ],
    "types": {
      "covid_19_deaths": "integer",
      "data_as_of": "date",
      "influenza_deaths": "integer",
      "mmwr_week": "integer",
      "mmwr_year": "integer",
      "percent_of_expected_deaths": "number",
      "pneumonia_and_covid_19_deaths": "integer",
      "pneumonia_deaths": "integer",
      "pneumonia_influenza_or_covid_19_deaths": "integer",
      "total_deaths": "integer",
      "week": "date"
    }
  },
  "schedule": "daily",
  "key_field": "week"
}

The request body used by the API, CLI and SDK examples.

{
  "name": "U.S. provisional weekly deaths from COVID-19, influenza and pneumonia",
  "url": "https://data.cdc.gov/resource/r8kw-7aab.json?$select=week_ending_date,year,mmwr_week,total_deaths,covid_19_deaths,influenza_deaths,pneumonia_deaths,pneumonia_and_covid_19_deaths,pneumonia_influenza_or_covid_19_deaths,percent_of_expected_deaths,data_as_of&$where=state=%27United%20States%27%20AND%20week_ending_date%20IS%20NOT%20NULL&$order=week_ending_date%20DESC&$limit=52",
  "recipe": {
    "mode": "http",
    "format": "json",
    "items": "[*]",
    "fields": {
      "week": "week_ending_date",
      "mmwr_week": "mmwr_week",
      "mmwr_year": "year",
      "data_as_of": "data_as_of",
      "total_deaths": "total_deaths",
      "covid_19_deaths": "covid_19_deaths",
      "influenza_deaths": "influenza_deaths",
      "pneumonia_deaths": "pneumonia_deaths",
      "percent_of_expected_deaths": "percent_of_expected_deaths",
      "pneumonia_and_covid_19_deaths": "pneumonia_and_covid_19_deaths",
      "pneumonia_influenza_or_covid_19_deaths": "pneumonia_influenza_or_covid_19_deaths"
    },
    "required": [
      "week"
    ],
    "types": {
      "week": "date",
      "mmwr_week": "integer",
      "mmwr_year": "integer",
      "data_as_of": "date",
      "total_deaths": "integer",
      "covid_19_deaths": "integer",
      "influenza_deaths": "integer",
      "pneumonia_deaths": "integer",
      "percent_of_expected_deaths": "number",
      "pneumonia_and_covid_19_deaths": "integer",
      "pneumonia_influenza_or_covid_19_deaths": "integer"
    }
  },
  "key_field": "week",
  "schedule": "daily",
  "rights": true,
  "catalog": {
    "slug": "cdc-nchs-provisional-weekly-deaths",
    "version_id": "cb358667-a700-40e9-b15d-5f5e1bfab25c"
  }
}

Create an API key under Console → API keys. Reference: /docs/api.

# the Verified entry (fields, recipe, sample, terms) as JSON
curl https://sourcefinch.com/v1/catalog/cdc-nchs-provisional-weekly-deaths -H "Authorization: Bearer $SOURCEFINCH_API_KEY"

# create the monitor from source.json (below)
curl -X POST https://sourcefinch.com/v1/sources \
  -H "Authorization: Bearer $SOURCEFINCH_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d @source.json

# then run it now (later runs follow the schedule)
curl -X POST https://sourcefinch.com/v1/sources/$SOURCE_ID/runs \
  -H "Authorization: Bearer $SOURCEFINCH_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

The sourcefinch CLI is not on npm yet; see /docs/cli.

sourcefinch login
sourcefinch catalog get cdc-nchs-provisional-weekly-deaths --source-json > source.json
sourcefinch sources create --file source.json
sourcefinch runs create $SOURCE_ID --wait
sourcefinch records $SOURCE_ID

The SDK is not on npm yet; see /docs/sdk.

import { SourceFinch } from "@sourcefinch/sdk";

const sf = new SourceFinch({ apiKey: process.env.SOURCEFINCH_API_KEY });
const entry = await sf.catalog.get("cdc-nchs-provisional-weekly-deaths");
const source = await sf.sources.create({
  catalog: { slug: entry.slug, version_id: entry.recipe.version_id },
  name: entry.name.slice(0, 100),
  url: entry.acquisition_path.endpoint,
  recipe: entry.recipe.definition,
  key_field: entry.recipe.key_field,
  schedule: entry.recipe.schedule,
  rights: true, // you confirm you have the right to collect this source
});
const run = await sf.runs.wait((await sf.runs.create(source.id)).id);
console.log(run.status);

Remote MCP server with OAuth; see /docs/mcp.

claude mcp add --transport http sourcefinch https://sourcefinch.com/mcp

# then ask your agent:
"Use SourceFinch to monitor U.S. provisional weekly deaths from COVID-19, influenza and pneumonia: get_catalog_source cdc-nchs-provisional-weekly-deaths,
then create_source with its create_source_args (dry run first), then run_source."