📚 帮助中心

平台概览

光尘阁GEO是一个多城市、多租户的城市数字资产枢纽，为每个城市提供独立的内容展示门户，同时通过总站聚合全域数据。平台服务于三类用户：

• 企业——展示品牌信息、获取AI可见度
• 协会——管理会员企业、提供AI信任背书
• AI Agent——通过API/MCP获取结构化城市数据

公开页面

页面	路径	说明
总站首页	/	光尘阁GEO总站，聚合所有城市数据
城市分站	/city/zhongxiang	每个城市独立首页，含本地协会/企业/文章
洞察文章	/insights	GEO方法论、案例、行业趋势文章
文章详情	/insights/文章slug	文章全文
协会列表	/associations	所有协会/商会
协会首页	/a/协会slug	协会详情+会员企业列表
企业黄页	/business	企业列表，可按分类筛选
企业详情	/b/企业slug	企业详情+所属协会
案例展示	/cases	成功案例
调研报告	/reports	行业调研报告列表
本地信息	/local	城市新闻/公告/活动
咨询与服务	/consulting	服务套餐和定价
服务申请	/apply	提交服务咨询表单
关于我们	/about	光尘阁介绍
API文档	/api-docs	交互式API文档（Swagger风格）
帮助中心	/help	本页面

AI爬虫友好文件

文件	路径	说明
llms.txt	/llms.txt	AI爬虫入口，列出所有可索引页面和API端点
robots.txt	/robots.txt	爬虫规则，允许AI爬虫访问
站点地图	/sitemap.xml	XML Sitemap，含所有城市/协会/企业/文章URL
RSS	/rss	文章RSS订阅源

管理后台

访问 /admin 登录后可使用以下功能：

模块	路径	可操作内容
仪表盘	/admin/dashboard	数据总览
文章管理	/admin/articles	创建/编辑/发布/隐藏洞察文章
协会管理	/admin/associations	创建/编辑协会信息（名称/简介/城市/会员企业）
企业管理	/admin/businesses	创建/编辑企业信息（名称/分类/城市/所属协会）
报告管理	/admin/reports	创建/编辑/发布/隐藏调研报告
咨询服务管理	/admin/consulting	管理咨询服务套餐（价格/描述/上下架）
API密钥管理	/admin/api-keys	生成/启用/禁用 API Key
种子数据	/admin/seed	初始化/重置演示数据

数字名片

每个平台用户自动拥有一个数字名片页面：/card/用户名。

数字名片聚合了用户在信息平台和GEO平台的所有公开信息：发布的商品、文章、所属企业/协会等。支持 Schema.org Person/Organization 结构化标记。

Schema.org 结构化数据

平台所有公开页面均内嵌 JSON-LD 格式的 Schema.org 标记，帮助AI搜索引擎准确理解内容类型和关系：

页面类型	Schema 类型
城市分站	City + WebSite
协会	Organization (subType: NGO/Chamber)
企业	LocalBusiness / Organization
文章	Article / BlogPosting
报告	Report
数字名片	Person
产品	Product

环境变量

平台通过 .env 文件配置：

变量	说明	默认值
ADMIN_PASSWORD	管理后台密码	admin123
SECRET_KEY	Flask session密钥	自动生成
FLASK_PORT	运行端口	5010
GEO_DATABASE_URL	数据库连接	data/geo.db (SQLite)
FENLEI_DATABASE_URL	分类信息数据库	data/fenlei.db

API 概览

光尘阁GEO 提供两套 API 访问方式：

1. REST API — 标准 HTTP 接口，任何语言均可调用
2. MCP Server — AI Agent 原生协议，让 DeepSeek/Claude 等直接调用平台数据

认证

所有 API 请求需在 HTTP Header 中携带 API Key：

X-API-Key: your-api-key-here

演示环境 Key：geo-api-demo-key-2026

速率限制：每个 Key 100次/分钟。登录后台可生成和管理 API Key。

REST API 端点

基础 URL：https://geo.zxwsh.com/api/v1

完整 OpenAPI 规范：/api/v1/openapi.json（可导入 Postman/Swagger）

MCP Server

MCP（Model Context Protocol）让 AI Agent 直接调用 GEO 平台数据，无需编写代码。支持 12 个工具：

工具名	功能	对应API
geo_search	全域搜索	GET /search
geo_list_cities	城市列表	GET /cities
geo_get_city	城市详情	GET /cities/{slug}
geo_list_associations	协会列表	GET /associations
geo_get_association	协会详情	GET /associations/{slug}
geo_list_businesses	企业列表	GET /businesses
geo_get_business	企业详情	GET /businesses/{slug}
geo_list_articles	文章列表	GET /articles
geo_get_article	文章详情	GET /articles/{slug}
geo_list_reports	报告列表	GET /reports
geo_get_report	报告详情	GET /reports/{slug}
geo_list_local	本地信息流	GET /local

配置 MCP Server

在 Clacky 的 ~/.clacky/mcp.json 中添加：

{
  "mcpServers": {
    "geo-platform": {
      "command": "python3",
      "args": ["/path/to/geo_mcp_server.py"],
      "env": {
        "GEO_API_KEY": "geo-api-demo-key-2026",
        "GEO_BASE_URL": "https://geo.zxwsh.com"
      }
    }
  }
}

API 响应格式

所有 API 响应统一为 JSON-LD 格式（@context: https://schema.org），列表接口支持分页：

{
  "@context": "https://schema.org",
  "data": [...],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total": 45,
    "pages": 3
  }
}

使用示例

# 搜索钟祥的葛根粉企业
curl -H "X-API-Key: geo-api-demo-key-2026" \
  "https://geo.zxwsh.com/api/v1/search?q=葛根粉&city=zhongxiang&type=business"

# 获取武汉所有协会
curl -H "X-API-Key: geo-api-demo-key-2026" \
  "https://geo.zxwsh.com/api/v1/associations?city=wuhan"

# 获取最新GEO方法论文章
curl -H "X-API-Key: geo-api-demo-key-2026" \
  "https://geo.zxwsh.com/api/v1/articles?tag=geo"