diff --git a/examples/detail-page.html b/examples/detail-page.html
new file mode 100644
index 0000000..93a4d84
--- /dev/null
+++ b/examples/detail-page.html
@@ -0,0 +1 @@
+
广东省公共资源交易平台交易环节
- 全部
- 招标公告及资格预审
- 中标候选人公示
- 中标结果
- 合同订立及履约
相关分类
- 全部
- 房屋建筑和市政基础设施工程
- 交通运输工程
- 水利工程
- 其他工程
发布时间
- 最近1年
- 最近7天
- 最近15天
- 最近1个月
- 最近3个月
- 自定义
开始日期
- 1月
- 2月
- 3月
- 4月
- 5月
- 6月
- 7月
- 8月
- 9月
- 10月
- 11月
- 12月
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
今天
结束日期
- 1月
- 2月
- 3月
- 4月
- 5月
- 6月
- 7月
- 8月
- 9月
- 10月
- 11月
- 12月
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
今天
温馨提醒:平台默认展示或搜索最近1年交易公开数据,选择【自定义】时间可查询更多公告信息。
新 深圳东至笋岗动走线工程邻近营业线项目第三方监测招标-深圳东至笋岗动走线工程邻近营业线项目第三方监测招标
工程建设 | 铁路
招标公告、资格预审公告
广交易数字交易平台
发布时间:2026-02-04
新 新建广西乐业通用机场项目民航专业工程监理-新建广西乐业通用机场项目民航专业工程监理
新 海口南货场扩建工程勘察设计招标-海口南货场扩建工程勘察设计招标
新 阳江国际风电城核心区人才之家项目(一期)全过程工程咨询(工程监理+工程造价咨询)-阳江国际风电城核心区人才之家项目_阳江国际风电城核心区人才之家项目(一期)全过程工程咨询(工程监理+工程造价咨询)
新 民众镇沙仔涌水闸及部分相连大堤重建工程(二标段)
工程建设 | 水利
招标公告、资格预审公告
中山市公共资源交易平台
发布时间:2026-02-04
新 中山市古镇镇北海站110千伏电缆线路土建工程勘察设计(第二次)
工程建设 | 市政
招标公告、资格预审公告
中山市公共资源交易平台
发布时间:2026-02-04
新 新会区罗坑镇县道X531线牛湾至东坑段道路升级改造项目设计施工总承包招标失败公告
工程建设 | 公路
招标异常情况报告
江门市公共资源交易平台
发布时间:2026-02-04
新 潮州市潮安区城市更新改造(一期)项目(赤凤片区)设计施工总承包合同
工程建设 | 房屋建筑
项目合同
潮州市公共资源交易平台
发布时间:2026-02-04
新 水贝李屋工业安置房项目结果公告
工程建设 | 房屋建筑
招标公告、资格预审公告
东莞市公共资源交易平台
发布时间:2026-02-04
新 广东省东莞市寮步香市非遗传承基地项目工程勘察服务
工程建设 | 房屋建筑
招标公告、资格预审公告
东莞市公共资源交易平台
发布时间:2026-02-04

交易系统
广东省- 省级
- 广州市
- 深圳市
- 珠海市
- 汕头市
- 佛山市
- 韶关市
- 河源市
- 梅州市
- 惠州市
- 汕尾市
- 东莞市
- 中山市
- 江门市
- 阳江市
- 湛江市
- 茂名市
- 肇庆市
- 清远市
- 潮州市
- 揭阳市
- 云浮市
- 广东省
- 省级
- 广州市
- 深圳市
- 珠海市
- 汕头市
- 佛山市
- 韶关市
- 河源市
- 梅州市
- 惠州市
- 汕尾市
- 东莞市
- 中山市
- 江门市
- 阳江市
- 湛江市
- 茂名市
- 肇庆市
- 清远市
- 潮州市
- 揭阳市
- 云浮市
\ No newline at end of file
diff --git a/examples/detail-url.json b/examples/detail-url.json
new file mode 100644
index 0000000..ae3b05f
--- /dev/null
+++ b/examples/detail-url.json
@@ -0,0 +1,42 @@
+
+{
+ "data": {
+ "docId": "a51f4d69-60a8-42be-972b-fd0d68e6df77-3C14",
+ "noticeId": "a51f4d69-60a8-42be-972b-fd0d68e6df77",
+ "noticeType": "trading-type",
+ "noticeTypeDesc": "交易公告",
+ "noticeSecondType": "A",
+ "noticeSecondTypeDesc": "工程建设",
+ "noticeThirdType": "1",
+ "noticeThirdTypeDesc": "招标公告与资格预审公告",
+ "projectType": "A04",
+ "projectTypeName": "铁路",
+ "siteName": "深圳市",
+ "siteCode": "440300",
+ "regionCode": "440300",
+ "regionName": "深圳市",
+ "noticeTitle": "深圳东至笋岗动走线工程邻近营业线项目第三方监测招标-深圳东至笋岗动走线工程邻近营业线项目第三方监测招标",
+ "projectOwner": "中国铁路广州局集团有限公司深圳工程建设指挥部",
+ "highlightNoticeTitle": null,
+ "highlightNoticeContent": null,
+ "linkUrl": null,
+ "publishOrgan": null,
+ "publishWay": null,
+ "documentNumber": null,
+ "projectCode": "E4401000002600157001",
+ "createAt": null,
+ "publishDate": "20260204173002",
+ "ifResult": null,
+ "edition": "v3",
+ "tradingProcess": "3C14",
+ "datasetName": "招标公告、资格预审公告",
+ "enactDate": null,
+ "executeDate": null,
+ "pubServicePlatCode": "12440100088216243C",
+ "pubServicePlat": "广交易数字交易平台",
+ "bizCode": null,
+ "noticeNature": "正常公告",
+ "refCodeMap": null
+ },
+ "detailUrl": "https://ygp.gdzwfw.gov.cn/#/44/new/jygg/v3/A?noticeId=a51f4d69-60a8-42be-972b-fd0d68e6df77&projectCode=E4401000002600157001&bizCode=3C14&siteCode=440300&publishDate=20260204173002&source=%E5%B9%BF%E4%BA%A4%E6%98%93%E6%95%B0%E5%AD%97%E4%BA%A4%E6%98%93%E5%B9%B3%E5%8F%B0&titleDetails=%E5%B7%A5%E7%A8%8B%E5%BB%BA%E8%AE%BE&classify=A04&nodeId=1993631416192262145"
+}
diff --git a/examples/list-page.html b/examples/list-page.html
new file mode 100644
index 0000000..5fc57ae
--- /dev/null
+++ b/examples/list-page.html
@@ -0,0 +1 @@
+广东省公共资源交易平台交易环节
- 全部
- 招标公告及资格预审
- 中标候选人公示
- 中标结果
- 合同订立及履约
相关分类
- 全部
- 房屋建筑和市政基础设施工程
- 交通运输工程
- 水利工程
- 其他工程
发布时间
- 最近1年
- 最近7天
- 最近15天
- 最近1个月
- 最近3个月
- 自定义
开始日期
- 1月
- 2月
- 3月
- 4月
- 5月
- 6月
- 7月
- 8月
- 9月
- 10月
- 11月
- 12月
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
今天
结束日期
- 1月
- 2月
- 3月
- 4月
- 5月
- 6月
- 7月
- 8月
- 9月
- 10月
- 11月
- 12月
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
今天
温馨提醒:平台默认展示或搜索最近1年交易公开数据,选择【自定义】时间可查询更多公告信息。
新 深圳东至笋岗动走线工程邻近营业线项目第三方监测招标-深圳东至笋岗动走线工程邻近营业线项目第三方监测招标
工程建设 | 铁路
招标公告、资格预审公告
广交易数字交易平台
发布时间:2026-02-04
新 新建广西乐业通用机场项目民航专业工程监理-新建广西乐业通用机场项目民航专业工程监理
新 海口南货场扩建工程勘察设计招标-海口南货场扩建工程勘察设计招标
新 阳江国际风电城核心区人才之家项目(一期)全过程工程咨询(工程监理+工程造价咨询)-阳江国际风电城核心区人才之家项目_阳江国际风电城核心区人才之家项目(一期)全过程工程咨询(工程监理+工程造价咨询)
新 民众镇沙仔涌水闸及部分相连大堤重建工程(二标段)
工程建设 | 水利
招标公告、资格预审公告
中山市公共资源交易平台
发布时间:2026-02-04
新 中山市古镇镇北海站110千伏电缆线路土建工程勘察设计(第二次)
工程建设 | 市政
招标公告、资格预审公告
中山市公共资源交易平台
发布时间:2026-02-04
新 新会区罗坑镇县道X531线牛湾至东坑段道路升级改造项目设计施工总承包招标失败公告
工程建设 | 公路
招标异常情况报告
江门市公共资源交易平台
发布时间:2026-02-04
新 潮州市潮安区城市更新改造(一期)项目(赤凤片区)设计施工总承包合同
工程建设 | 房屋建筑
项目合同
潮州市公共资源交易平台
发布时间:2026-02-04
新 水贝李屋工业安置房项目结果公告
工程建设 | 房屋建筑
招标公告、资格预审公告
东莞市公共资源交易平台
发布时间:2026-02-04
新 广东省东莞市寮步香市非遗传承基地项目工程勘察服务
工程建设 | 房屋建筑
招标公告、资格预审公告
东莞市公共资源交易平台
发布时间:2026-02-04

交易系统
广东省- 省级
- 广州市
- 深圳市
- 珠海市
- 汕头市
- 佛山市
- 韶关市
- 河源市
- 梅州市
- 惠州市
- 汕尾市
- 东莞市
- 中山市
- 江门市
- 阳江市
- 湛江市
- 茂名市
- 肇庆市
- 清远市
- 潮州市
- 揭阳市
- 云浮市
- 广东省
- 省级
- 广州市
- 深圳市
- 珠海市
- 汕头市
- 佛山市
- 韶关市
- 河源市
- 梅州市
- 惠州市
- 汕尾市
- 东莞市
- 中山市
- 江门市
- 阳江市
- 湛江市
- 茂名市
- 肇庆市
- 清远市
- 潮州市
- 揭阳市
- 云浮市
\ No newline at end of file
diff --git a/examples/list-request.sh b/examples/list-request.sh
new file mode 100644
index 0000000..5edef83
--- /dev/null
+++ b/examples/list-request.sh
@@ -0,0 +1,20 @@
+curl 'https://ygp.gdzwfw.gov.cn/ggzy-portal/search/v2/items' \
+ -H 'Accept: application/json, text/plain, */*' \
+ -H 'Accept-Language: zh-CN,zh;q=0.9' \
+ -H 'Connection: keep-alive' \
+ -H 'Content-Type: application/json' \
+ -b '_horizon_sid=85f7f27a-a1ca-4d3b-87b1-9c733b1d846c; _horizon_uid=ec39e18f-7968-4277-afeb-0bea42d5de45' \
+ -H 'Origin: https://ygp.gdzwfw.gov.cn' \
+ -H 'Referer: https://ygp.gdzwfw.gov.cn/' \
+ -H 'Sec-Fetch-Dest: empty' \
+ -H 'Sec-Fetch-Mode: cors' \
+ -H 'Sec-Fetch-Site: same-origin' \
+ -H 'User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/144.0.0.0 Safari/537.36' \
+ -H 'X-Dgi-Req-App: ggzy-portal' \
+ -H 'X-Dgi-Req-Nonce: xHui3fC2RmcIuHyQ' \
+ -H 'X-Dgi-Req-Signature: ccd2c2a549d3ea1932cb4e843715be6c414af04b1f025ca62686913efb5b3d39' \
+ -H 'X-Dgi-Req-Timestamp: 1770198773779' \
+ -H 'sec-ch-ua: "Not(A:Brand";v="8", "Chromium";v="144", "Google Chrome";v="144"' \
+ -H 'sec-ch-ua-mobile: ?0' \
+ -H 'sec-ch-ua-platform: "macOS"' \
+ --data-raw '{"type":"trading-type","openConvert":false,"keyword":"","siteCode":"44","secondType":"A","tradingProcess":"","thirdType":"[]","projectType":"","publishStartTime":"","publishEndTime":"","pageNo":2,"pageSize":10}'
\ No newline at end of file
diff --git a/examples/list-response.json b/examples/list-response.json
new file mode 100644
index 0000000..bbbdb24
--- /dev/null
+++ b/examples/list-response.json
@@ -0,0 +1,392 @@
+{
+ "errcode": 0,
+ "errmsg": "ok",
+ "data": {
+ "pageNo": 2,
+ "pageSize": 10,
+ "pageTotal": 13346,
+ "total": "133451",
+ "pageData": [
+ {
+ "docId": "a51f4d69-60a8-42be-972b-fd0d68e6df77-3C14",
+ "noticeId": "a51f4d69-60a8-42be-972b-fd0d68e6df77",
+ "noticeType": "trading-type",
+ "noticeTypeDesc": "交易公告",
+ "noticeSecondType": "A",
+ "noticeSecondTypeDesc": "工程建设",
+ "noticeThirdType": "1",
+ "noticeThirdTypeDesc": "招标公告与资格预审公告",
+ "projectType": "A04",
+ "projectTypeName": "铁路",
+ "siteName": "深圳市",
+ "siteCode": "440300",
+ "regionCode": "440300",
+ "regionName": "深圳市",
+ "noticeTitle": "深圳东至笋岗动走线工程邻近营业线项目第三方监测招标-深圳东至笋岗动走线工程邻近营业线项目第三方监测招标",
+ "projectOwner": "中国铁路广州局集团有限公司深圳工程建设指挥部",
+ "highlightNoticeTitle": null,
+ "highlightNoticeContent": null,
+ "linkUrl": null,
+ "publishOrgan": null,
+ "publishWay": null,
+ "documentNumber": null,
+ "projectCode": "E4401000002600157001",
+ "createAt": null,
+ "publishDate": "20260204173002",
+ "ifResult": null,
+ "edition": "v3",
+ "tradingProcess": "3C14",
+ "datasetName": "招标公告、资格预审公告",
+ "enactDate": null,
+ "executeDate": null,
+ "pubServicePlatCode": "12440100088216243C",
+ "pubServicePlat": "广交易数字交易平台",
+ "bizCode": null,
+ "noticeNature": "正常公告",
+ "refCodeMap": null
+ },
+ {
+ "docId": "69951882-04c1-46ac-9e88-93dd5c7ef066-3C52",
+ "noticeId": "69951882-04c1-46ac-9e88-93dd5c7ef066",
+ "noticeType": "trading-type",
+ "noticeTypeDesc": "交易公告",
+ "noticeSecondType": "A",
+ "noticeSecondTypeDesc": "工程建设",
+ "noticeThirdType": "4",
+ "noticeThirdTypeDesc": "中标结果",
+ "projectType": "A05",
+ "projectTypeName": "民航",
+ "siteName": "百色市",
+ "siteCode": "451000",
+ "regionCode": "44",
+ "regionName": "省外区划特殊转换_百色市",
+ "noticeTitle": "新建广西乐业通用机场项目民航专业工程监理-新建广西乐业通用机场项目民航专业工程监理",
+ "projectOwner": "广西乐业领航低空经济发展有限公司",
+ "highlightNoticeTitle": null,
+ "highlightNoticeContent": null,
+ "linkUrl": null,
+ "publishOrgan": null,
+ "publishWay": null,
+ "documentNumber": null,
+ "projectCode": "E4401000002505663001",
+ "createAt": null,
+ "publishDate": "20260204173002",
+ "ifResult": null,
+ "edition": "v3",
+ "tradingProcess": "3C52",
+ "datasetName": "结果公示",
+ "enactDate": null,
+ "executeDate": null,
+ "pubServicePlatCode": "12440100088216243C",
+ "pubServicePlat": "广交易数字交易平台",
+ "bizCode": null,
+ "noticeNature": "正常公告",
+ "refCodeMap": null
+ },
+ {
+ "docId": "9b4b4a0d-4379-4445-b803-9fb2fa8d123a-3C52",
+ "noticeId": "9b4b4a0d-4379-4445-b803-9fb2fa8d123a",
+ "noticeType": "trading-type",
+ "noticeTypeDesc": "交易公告",
+ "noticeSecondType": "A",
+ "noticeSecondTypeDesc": "工程建设",
+ "noticeThirdType": "4",
+ "noticeThirdTypeDesc": "中标结果",
+ "projectType": "A04",
+ "projectTypeName": "铁路",
+ "siteName": "海口市",
+ "siteCode": "460100",
+ "regionCode": "44",
+ "regionName": "省外区划特殊转换_海口市",
+ "noticeTitle": "海口南货场扩建工程勘察设计招标-海口南货场扩建工程勘察设计招标",
+ "projectOwner": "海南铁路有限公司",
+ "highlightNoticeTitle": null,
+ "highlightNoticeContent": null,
+ "linkUrl": null,
+ "publishOrgan": null,
+ "publishWay": null,
+ "documentNumber": null,
+ "projectCode": "E4401000002505726001",
+ "createAt": null,
+ "publishDate": "20260204173002",
+ "ifResult": null,
+ "edition": "v3",
+ "tradingProcess": "3C52",
+ "datasetName": "结果公示",
+ "enactDate": null,
+ "executeDate": null,
+ "pubServicePlatCode": "12440100088216243C",
+ "pubServicePlat": "广交易数字交易平台",
+ "bizCode": null,
+ "noticeNature": "正常公告",
+ "refCodeMap": null
+ },
+ {
+ "docId": "0a33b12e-2ea6-4e1b-b62f-bc178e687ca2-3C52",
+ "noticeId": "0a33b12e-2ea6-4e1b-b62f-bc178e687ca2",
+ "noticeType": "trading-type",
+ "noticeTypeDesc": "交易公告",
+ "noticeSecondType": "A",
+ "noticeSecondTypeDesc": "工程建设",
+ "noticeThirdType": "4",
+ "noticeThirdTypeDesc": "中标结果",
+ "projectType": "A01",
+ "projectTypeName": "房屋建筑",
+ "siteName": "阳江市",
+ "siteCode": "441700",
+ "regionCode": "441700",
+ "regionName": "阳江市",
+ "noticeTitle": "阳江国际风电城核心区人才之家项目(一期)全过程工程咨询(工程监理+工程造价咨询)-阳江国际风电城核心区人才之家项目_阳江国际风电城核心区人才之家项目(一期)全过程工程咨询(工程监理+工程造价咨询)",
+ "projectOwner": "阳江市寰海风电科技有限公司",
+ "highlightNoticeTitle": null,
+ "highlightNoticeContent": null,
+ "linkUrl": null,
+ "publishOrgan": null,
+ "publishWay": null,
+ "documentNumber": null,
+ "projectCode": "E4401000002503126001",
+ "createAt": null,
+ "publishDate": "20260204173002",
+ "ifResult": null,
+ "edition": "v3",
+ "tradingProcess": "3C52",
+ "datasetName": "结果公示",
+ "enactDate": null,
+ "executeDate": null,
+ "pubServicePlatCode": "12440100088216243C",
+ "pubServicePlat": "广交易数字交易平台",
+ "bizCode": null,
+ "noticeNature": "正常公告",
+ "refCodeMap": null
+ },
+ {
+ "docId": "1f792d8e-ae31-4d04-b352-16322ea8da96-3C14",
+ "noticeId": "1f792d8e-ae31-4d04-b352-16322ea8da96",
+ "noticeType": "trading-type",
+ "noticeTypeDesc": "交易公告",
+ "noticeSecondType": "A",
+ "noticeSecondTypeDesc": "工程建设",
+ "noticeThirdType": "1",
+ "noticeThirdTypeDesc": "招标公告与资格预审公告",
+ "projectType": "A07",
+ "projectTypeName": "水利",
+ "siteName": "中山市",
+ "siteCode": "442000",
+ "regionCode": "442000",
+ "regionName": "中山市",
+ "noticeTitle": "民众镇沙仔涌水闸及部分相连大堤重建工程(二标段)",
+ "projectOwner": "中山火炬高技术产业开发区水务事务中心",
+ "highlightNoticeTitle": null,
+ "highlightNoticeContent": null,
+ "linkUrl": null,
+ "publishOrgan": null,
+ "publishWay": null,
+ "documentNumber": null,
+ "projectCode": "E4420002712020387001",
+ "createAt": null,
+ "publishDate": "20260204172915",
+ "ifResult": null,
+ "edition": "v3",
+ "tradingProcess": "3C14",
+ "datasetName": "招标公告、资格预审公告",
+ "enactDate": null,
+ "executeDate": null,
+ "pubServicePlatCode": "12442000091769607Y",
+ "pubServicePlat": "中山市公共资源交易平台",
+ "bizCode": null,
+ "noticeNature": "正常公告",
+ "refCodeMap": null
+ },
+ {
+ "docId": "e9535048-4bb1-43e8-8054-2b386f7a4230-3C14",
+ "noticeId": "e9535048-4bb1-43e8-8054-2b386f7a4230",
+ "noticeType": "trading-type",
+ "noticeTypeDesc": "交易公告",
+ "noticeSecondType": "A",
+ "noticeSecondTypeDesc": "工程建设",
+ "noticeThirdType": "1",
+ "noticeThirdTypeDesc": "招标公告与资格预审公告",
+ "projectType": "A02",
+ "projectTypeName": "市政",
+ "siteName": "中山市",
+ "siteCode": "442000",
+ "regionCode": "442000",
+ "regionName": "中山市",
+ "noticeTitle": "中山市古镇镇北海站110千伏电缆线路土建工程勘察设计(第二次)",
+ "projectOwner": "中山市古镇镇城市建设和管理局",
+ "highlightNoticeTitle": null,
+ "highlightNoticeContent": null,
+ "linkUrl": null,
+ "publishOrgan": null,
+ "publishWay": null,
+ "documentNumber": null,
+ "projectCode": "E4420002712020392001",
+ "createAt": null,
+ "publishDate": "20260204172905",
+ "ifResult": null,
+ "edition": "v3",
+ "tradingProcess": "3C14",
+ "datasetName": "招标公告、资格预审公告",
+ "enactDate": null,
+ "executeDate": null,
+ "pubServicePlatCode": "12442000091769607Y",
+ "pubServicePlat": "中山市公共资源交易平台",
+ "bizCode": null,
+ "noticeNature": "正常公告",
+ "refCodeMap": null
+ },
+ {
+ "docId": "297e86c99b913784019c27f9c6876216-3C81",
+ "noticeId": "297e86c99b913784019c27f9c6876216",
+ "noticeType": "trading-type",
+ "noticeTypeDesc": "交易公告",
+ "noticeSecondType": "A",
+ "noticeSecondTypeDesc": "工程建设",
+ "noticeThirdType": "6",
+ "noticeThirdTypeDesc": "招标异常情况报告",
+ "projectType": "A03",
+ "projectTypeName": "公路",
+ "siteName": "新会区",
+ "siteCode": "440705",
+ "regionCode": "440700",
+ "regionName": "江门市",
+ "noticeTitle": "新会区罗坑镇县道X531线牛湾至东坑段道路升级改造项目设计施工总承包招标失败公告",
+ "projectOwner": "江门市新会区罗坑镇人民政府",
+ "highlightNoticeTitle": null,
+ "highlightNoticeContent": null,
+ "linkUrl": null,
+ "publishOrgan": null,
+ "publishWay": null,
+ "documentNumber": null,
+ "projectCode": "E4407010802004655001",
+ "createAt": null,
+ "publishDate": "20260204172605",
+ "ifResult": null,
+ "edition": "v3",
+ "tradingProcess": "3C81",
+ "datasetName": "招标异常情况报告",
+ "enactDate": null,
+ "executeDate": null,
+ "pubServicePlatCode": "124407000718835921",
+ "pubServicePlat": "江门市公共资源交易平台",
+ "bizCode": null,
+ "noticeNature": "",
+ "refCodeMap": null
+ },
+ {
+ "docId": "3C61643610ebe7c843cea226a03ea6905d73-3C61",
+ "noticeId": "3C61643610ebe7c843cea226a03ea6905d73",
+ "noticeType": "trading-type",
+ "noticeTypeDesc": "交易公告",
+ "noticeSecondType": "A",
+ "noticeSecondTypeDesc": "工程建设",
+ "noticeThirdType": "",
+ "noticeThirdTypeDesc": null,
+ "projectType": "A01",
+ "projectTypeName": "房屋建筑",
+ "siteName": "潮州市",
+ "siteCode": "445100",
+ "regionCode": "445100",
+ "regionName": "潮州市",
+ "noticeTitle": "潮州市潮安区城市更新改造(一期)项目(赤凤片区)设计施工总承包合同",
+ "projectOwner": "潮州市潮安区赤凤镇人民政府",
+ "highlightNoticeTitle": null,
+ "highlightNoticeContent": null,
+ "linkUrl": null,
+ "publishOrgan": null,
+ "publishWay": null,
+ "documentNumber": null,
+ "projectCode": "E4451002744a12618001",
+ "createAt": null,
+ "publishDate": "20260204172335",
+ "ifResult": null,
+ "edition": "v3",
+ "tradingProcess": "3C61",
+ "datasetName": "项目合同",
+ "enactDate": null,
+ "executeDate": null,
+ "pubServicePlatCode": "124451003150112067",
+ "pubServicePlat": "潮州市公共资源交易平台",
+ "bizCode": null,
+ "noticeNature": "",
+ "refCodeMap": null
+ },
+ {
+ "docId": "6239ce1a-e8dc-4d58-9998-8f026e4b0001-3C14",
+ "noticeId": "6239ce1a-e8dc-4d58-9998-8f026e4b0001",
+ "noticeType": "trading-type",
+ "noticeTypeDesc": "交易公告",
+ "noticeSecondType": "A",
+ "noticeSecondTypeDesc": "工程建设",
+ "noticeThirdType": "1",
+ "noticeThirdTypeDesc": "招标公告与资格预审公告",
+ "projectType": "A01",
+ "projectTypeName": "房屋建筑",
+ "siteName": "东莞市",
+ "siteCode": "441900",
+ "regionCode": "441900",
+ "regionName": "东莞市",
+ "noticeTitle": "水贝李屋工业安置房项目结果公告",
+ "projectOwner": "东莞市石排镇水贝李屋股份经济合作社",
+ "highlightNoticeTitle": null,
+ "highlightNoticeContent": null,
+ "linkUrl": null,
+ "publishOrgan": null,
+ "publishWay": null,
+ "documentNumber": null,
+ "projectCode": "E4419000748011195001",
+ "createAt": null,
+ "publishDate": "20260204171930",
+ "ifResult": null,
+ "edition": "v3",
+ "tradingProcess": "3C14",
+ "datasetName": "招标公告、资格预审公告",
+ "enactDate": null,
+ "executeDate": null,
+ "pubServicePlatCode": "124419003519028823",
+ "pubServicePlat": "东莞市公共资源交易平台",
+ "bizCode": null,
+ "noticeNature": "正常公告",
+ "refCodeMap": null
+ },
+ {
+ "docId": "59a41536-2479-4eeb-a9fc-176424ef5a54-3C14",
+ "noticeId": "59a41536-2479-4eeb-a9fc-176424ef5a54",
+ "noticeType": "trading-type",
+ "noticeTypeDesc": "交易公告",
+ "noticeSecondType": "A",
+ "noticeSecondTypeDesc": "工程建设",
+ "noticeThirdType": "1",
+ "noticeThirdTypeDesc": "招标公告与资格预审公告",
+ "projectType": "A01",
+ "projectTypeName": "房屋建筑",
+ "siteName": "东莞市",
+ "siteCode": "441900",
+ "regionCode": "441900",
+ "regionName": "东莞市",
+ "noticeTitle": "广东省东莞市寮步香市非遗传承基地项目工程勘察服务",
+ "projectOwner": "东莞市寮步镇工程建设中心",
+ "highlightNoticeTitle": null,
+ "highlightNoticeContent": null,
+ "linkUrl": null,
+ "publishOrgan": null,
+ "publishWay": null,
+ "documentNumber": null,
+ "projectCode": "E4419000748011267001",
+ "createAt": null,
+ "publishDate": "20260204171856",
+ "ifResult": null,
+ "edition": "v3",
+ "tradingProcess": "3C14",
+ "datasetName": "招标公告、资格预审公告",
+ "enactDate": null,
+ "executeDate": null,
+ "pubServicePlatCode": "124419003519028823",
+ "pubServicePlat": "东莞市公共资源交易平台",
+ "bizCode": null,
+ "noticeNature": "正常公告",
+ "refCodeMap": null
+ }
+ ]
+ }
+}
\ No newline at end of file
diff --git a/requirements.md b/requirements.md
index 9a991ed..f32b58d 100644
--- a/requirements.md
+++ b/requirements.md
@@ -37,4 +37,48 @@
## 5. 开发语言
-- **编程语言**: Python
\ No newline at end of file
+- **编程语言**: Python
+
+## 6. 接口参考与数据示例
+
+根据 `examples/` 目录下的抓包数据,以下是接口分析结果:
+
+### 6.1. 列表页接口
+
+- **接口 URL**: `https://ygp.gdzwfw.gov.cn/ggzy-portal/search/v2/items`
+- **请求方式**: `POST`
+- **关键请求头**:
+ - `Content-Type`: `application/json`
+ - `X-Dgi-Req-Nonce`, `X-Dgi-Req-Signature`, `X-Dgi-Req-Timestamp`: 涉及请求签名,需要逆向分析 JS 或使用自动化工具处理。
+ - `_horizon_sid`, `_horizon_uid`: Cookie 参数。
+- **请求体 (Payload) 示例**:
+ ```json
+ {
+ "type": "trading-type",
+ "openConvert": false,
+ "keyword": "",
+ "siteCode": "44",
+ "secondType": "A",
+ "tradingProcess": "",
+ "thirdType": "[]",
+ "projectType": "",
+ "publishStartTime": "",
+ "publishEndTime": "",
+ "pageNo": 2,
+ "pageSize": 10
+ }
+ ```
+- **响应结构 (关键字段)**:
+ - `data.pageData`: 公告列表数组。
+ - `noticeTitle`: 公告标题。
+ - `publishDate`: 发布时间 (格式: `yyyyMMddHHmmss`)。
+ - `noticeThirdTypeDesc`: 公告类型描述 (筛选 "中标结果")。
+ - 构造详情页所需的字段: `noticeId`, `projectCode`, `tradingProcess` (作为 `bizCode`), `siteCode`, `pubServicePlat`, `noticeSecondTypeDesc`, `projectType`.
+
+### 6.2. 详情页链接构造
+
+详情页 URL 并非直接在列表接口返回,而是通过前端拼接。根据 `examples/detail-url.json` 和列表数据的对比,URL 模式如下:
+
+`https://ygp.gdzwfw.gov.cn/#/44/new/jygg/v3/A?noticeId={noticeId}&projectCode={projectCode}&bizCode={tradingProcess}&siteCode={siteCode}&publishDate={publishDate}&source={pubServicePlat}&titleDetails={noticeSecondTypeDesc}&classify={projectType}`
+
+*注: URL 中的参数值可能需要进行 URL 编码。`nodeId` 参数在示例 URL 中存在,但在列表响应中未直接发现,需确认是否必须或生成逻辑。*
\ No newline at end of file