academic-data-hunter

面向研究、竞赛与论文场景的可追溯数据采集与交付工具

Generate Convert Improve

Install / Use

claude mcp add Wack520 -- npx -y github:Wack520/academic-data-hunter

If the server publishes to npm under a different name, use that package instead — check the repo README.

About this skill

🔌

MCP Server

Model Context Protocol server

Quality Score

62/100

Skill content

View source on GitHub

Academic Data Hunter

公开数据采集与交付工作流框架

从公开来源检索、抽取、校验并交付可复核数据资产。

既可用于研究、论文、建模与分析，也可作为 Agent / MCP 工作流的数据层接入。

这是什么

Academic Data Hunter 用来把“找数据”变成“交付数据”。

它覆盖的是一整条 workflow，而不是单次搜索结果：

任务定义
来源检索
结构化抽取
来源登记
数据校验
Evidence Pack
Benchmark Eval

最终交付物

task spec
  -> dataset.csv
  -> source_registry.csv
  -> evidence_records.jsonl
  -> evidence pack
  -> benchmark eval

给谁用

研究 / 分析用户

定义公开数据任务
组织来源搜集与抽取
校验并交付可复核数据包

开发者 / Agent 用户

通过 CLI / API / MCP 接入 workflow
把 workflow 作为数据层与证据层
给 Agent 增加交付与评估能力

当前示例

当前仓库仍使用 cases/ 目录保存示例资产；这些目录代表现有 examples，不代表项目边界。

| 当前目录 | 当前角色 | |---|---| | cases/case01-nev-carbon/ | 中国区域面板类示例 | | cases/case02-nev-emission-controls/ | 控制变量补齐类示例 | | cases/case03-population-10y/ | 公共统计整理类示例 |

文档入口

快速开始

1）准备任务模板

Copy-Item templates/task-spec-template.md my-task.md

2）做数据校验

python scripts/validate_round.py `
  --data cases/case01-nev-carbon/data/charging_piles_by_province.csv `
  --registry cases/case01-nev-carbon/data/source_registry.csv `
  --variable charging `
  --value-col public_charging_piles `
  --check-unit 台

3）导出交付包

python scripts/export_evidence_pack.py `
  --data cases/case01-nev-carbon/data/charging_piles_by_province.csv `
  --registry cases/case01-nev-carbon/data/source_registry.csv `
  --variable charging `
  --value-col public_charging_piles `
  --output-dir tmp/evidence-pack/case01-charging

4）运行评估

python scripts/run_benchmark_eval.py `
  --data cases/case01-nev-carbon/data/charging_piles_by_province.csv `
  --registry cases/case01-nev-carbon/data/source_registry.csv `
  --variable charging `
  --value-col public_charging_piles `
  --year-start 2017 `
  --year-end 2023 `
  --output-json tmp/benchmark/case01-charging.json `
  --output-md tmp/benchmark/case01-charging.md