用途:本技能通过 inaturalist-pp-cli 二进制访问 iNaturalist 完整 API,面向有边界的物种发现、分类群研究、隐私安全的实地简报与观察鉴定进度查询,输出更适合智能体消费的数据或本地历史记录。
主要能力:提供 nearby highlights(不暴露观察坐标的近期野生动植物简报)、hunt create(基于周边真实观察到的分类群生成事实性寻宝清单)、nearby seasonal-shift(对比两个时间窗口,显示新出现、回归或显著变化的分类群)、observations id-status 与 id-changes(查看哪些观察已被鉴定、需要鉴定、存在分歧或缺乏分类群,并对比上次同步)。命令覆盖 annotations、comments、controlled-terms、flags、identifications、messages、observation-field-values、observation-photos、observations、places、posts、project-observations、projects、subscriptions、taxa、users、votes 等;可用 which 将自然语言能力查询映射到命令。
使用方式:需先安装 CLI,可用 npx -y @mvanhorn/printing-press-library install inaturalist --cli-only,或 go install github.com/mvanhorn/printing-press-library/library/other/inaturalist/cmd/inaturalist-pp-cli@latest,并确认 inaturalist-pp-cli --version 成功。命令加 --agent 展开为 --json --compact --no-input --no-color --yes;--select 可裁剪字段,--dry-run 预览请求,写操作需官方 JWT/OAuth 流程。路径可用 --home 或 INATURALIST_HOME 及各类环境变量重定位,MCP 场景需在宿主配置中传环境变量。
适用场景:本地野生动植物概览、自然教育活动清单、观察鉴定进度核对、时间窗口物种对比。
限制:不得用于恢复、推断或分享被遮蔽/私密观察坐标;不得用于批量数据或媒体抓取,应改用 iNaturalist 导出或 GBIF 数据集;未经明确审核与确认不得创建观察或做其他远程更改;公开读端点无需凭证,但认证响应可能含私有数据,复合工作流不得暴露或存储私密位置字段。