portaljs

用一句话描述需求，AI 自动生成数据门户并接入数据源

开源 🏷️定价信息待确认 ✅ 目前可打开智能体 🍴 复刻 339 🐛 待处理 16 👀 关注 94

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 2370

维护状态较活跃

是否开源开源

定价模式 🏷️定价信息待确认

项目预览

项目数据

分类智能体

开发团队datopian

官网地址https://www.portaljs.com

GitHubhttps://github.com/datopian/portaljs

定价模式🏷️定价信息待确认

价格说明定价信息待确认

访问状态✅ 目前可打开

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型agent-skills,ai,ai-agents,ckan,claude-code,data-mesh,data-portal,datahub,dataverse,dkan,mcp,nextjs,open-data,open-data-portal,opendatasoft,openmetadata,skills,socrata

GitHub 星标★ 2370

上线时间2011-10-14 00:00:00

代码更新2026-10-28

仓库体积225.6 MB

本站数据更新2026-11-10

维护状态较活跃

收录时间2026-08-09

浏览次数6

项目介绍

PortalJS 是一个 AI 原生的数据门户构建框架，旨在解决传统数据门户开发周期长、数据接入复杂的问题。它允许开发者通过自然语言描述需求，利用智能体技能自动生成完整的数据门户骨架，并在几分钟内接入 CKAN、GitHub、Frictionless 等多种后端数据源。核心能力包括：基于 Next.js 的现代前端框架、MCP 协议支持、可扩展的智能体技能库，以及数据网格（Data Mesh）理念的集成。通过 CLI 工具和 AI 协作，用户无需从零编写大量代码，即可快速搭建具备数据浏览、搜索、可视化等功能的数据门户。该项目特别适合开放数据平台、数据目录、数据网格等场景，降低了数据共享与发布的技术门槛。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 2370

技术标签

agent-skills ai ai-agents claude-code mcp

使用教程

难度：入门约 10 分钟部署方式：命令行工具 7 步

环境要求

Node.js 22 或更高版本（README 明确要求 Node 22+）
可用的 npm / npx 命令行环境
终端可访问网络（npm 源与 GitHub raw 文件）
可选：Claude Code，用于使用 PortalJS 技能自动建站

安装与启动步骤

1创建门户项目

在终端用一条命令生成名为 my-portal 的 Next.js 数据门户骨架，除 Node 22+ 外无需额外安装。
```
npm create portaljs@latest my-portal
```
2启动开发服务器

进入生成的 my-portal 目录并运行 dev 脚本，README 说明默认访问地址为 http://localhost:3000。
```
cd my-portal
npm run dev
```
3查看三个页面

浏览器打开后可见 Home、Catalog（/search）和数据集 Showcase（/@<namespace>/<slug>），内容为示例数据。
4安装 AI 技能

把 PortalJS 的 Claude Code 技能安装到 ~/.claude/commands，一次安装后任意目录都能调用，需重启或新开会话。
```
curl -fsSL https://raw.githubusercontent.com/datopian/portaljs/main/scripts/install-portaljs-skills.sh | bash
```
5自动生成门户

在 Claude Code 会话中用 /portaljs-new-portal 描述需求，即可生成 Home、Catalog、Showcase 三个界面。
```
/portaljs-new-portal "Auckland Council open data portal"
```
6接入自己的数据

把自有 CSV/JSON 加入 datasets.json，页面会自动渲染，无需手写代码；也可用 /portaljs-add-dataset 加载。
7备选：使用裸模板

不想用 AI 时，用 tiged 拉取 portaljs-catalog 示例模板，安装依赖后同样在 3000 端口启动。
```
npx tiged datopian/portaljs/examples/portaljs-catalog my-portal
cd my-portal && npm install && npm run dev
```

关键配置

配置项	必填	说明	示例
`datasets.json`	否	数据清单文件，加入自定义 CSV/JSON 后门户自动渲染	`air-quality.csv`

如何确认成功

运行 npm run dev 后，浏览器打开 http://localhost:3000，能看到 Home、/search 目录页与数据集 Showcase 页即成功。

常见问题

Q：需要预先安装什么环境？

A：README 说明除 Node 22+ 外不需要安装其他东西；项目脚手架与依赖由 npm create 自动拉取。

Q：不用 AI 助手可以建站吗？

A：可以。README 提供裸模板方式：npx tiged datopian/portaljs/examples/portaljs-catalog my-portal，再 npm install && npm run dev。

Q：安装技能后找不到 /portaljs 命令？

A：技能装在 ~/.claude/commands，需重启 Claude Code 或新开会话，然后输入 / 即可看到所有技能。

Q：如何换成自己的数据？

A：把自有的 CSV/JSON 文件加入 datasets.json，门户会自动渲染；也可调用 /portaljs-add-dataset 或 /portaljs-add-resource 加载数据。

Q：能不能对接 CKAN 后端？

A：可以，使用技能 /portaljs-connect-ckan 把门户指向 CKAN 后端，部署则用 /portaljs-deploy。

注意事项

开发服务器默认端口为 3000，README 中地址为 http://localhost:3000。
npm create 生成的模板是可自由编辑的普通 Next.js 项目，没有锁定，便于二次开发。
技能相关问题可参考仓库内的 .claude/INSTALL.md，README 提到还有版本化插件或从克隆仓库运行两种安装方式。
示例模板 portaljs-catalog 的路径为 datopian/portaljs/examples/portaljs-catalog，请勿改成其他路径。