mirror of https://git.openapi.site/https://github.com/desirecore/market.git synced 2026-09-05 21:43:46 +08:00

Files

joy1129-com c83f917901 feat(skills): add 6 due-diligence data-source skills (#111 )

## Summary

Adds six enterprise due-diligence data-source skills as local built-in
skills (SKILL.md + SKILL.zh-CN.md + catalog-metadata sidecar), per
ADR-038.

| Skill | Category | Risk | Source |
|---|---|---|---|
| baidu-poi-search | data | low | Baidu Map Place API (REST) |
| tianyancha-risk | business | low | Tianyancha risk API (REST) |
| ccgp-gov-procurement | business | medium | ccgp.gov.cn (WebBridge) |
| cnipa-patent-search | business | medium | CNIPA pss-system (WebBridge)
|
| creditchina-query | business | high | creditchina.gov.cn (WebBridge +
ddddocr) |
| multi-source-sentiment | research | medium | Douyin Index/Featured +
WebSearch |

## Changes
- 6 x skills/<id>/{SKILL.md, SKILL.zh-CN.md, catalog-metadata.v1.json}
- builtin-skills.json: 34 -> 40
- manifest.json: totalSkills 63 -> 69
- README.md counts + list

## Security
- Credentials replaced with env-var placeholders (BAIDU_MAP_AK,
TIANYANCHA_TOKEN); verified no secrets in diff

## Validation
- validate-i18n.py: 0 errors (remaining warnings pre-existing repo-wide)
- zh/en heading parity verified; source_hash computed per repo algorithm

Co-authored-by: yi-ge <yi-ge@desirecore.net>

2026-09-03 14:05:58 +08:00

5.9 KiB

Raw Blame History

name, description, version, type, risk_level, status, tags, metadata, market

name

description

version

type

risk_level

status

Baidu Map POI Search

L0: One-Sentence Summary

Input a company name, call the Baidu Map Place Search API, and return normalized POI data (name / address / coordinates / province & city).

L1: Overview

Data source: Baidu Map Open Platform Place Search API v2
Auth: AK (free quota for individual developers)
Invocation: HTTP GET (curl / HttpRequest tool)
Prerequisites: no browser, no extra dependencies — pure REST API

Credential Setup

This skill requires a Baidu Map AK (access key):

Register a developer account at the Baidu Map Open Platform
Console → App Management → Create an app (enable the "Place Search" service; choose the empty-whitelist 0.0.0.0/0 AK type)
Export the AK as the environment variable BAIDU_MAP_AK, or replace the {BAIDU_MAP_AK} placeholder in the commands below

If the local DesireCore service catalog already registers the Baidu Map service (endpoint https://api.map.baidu.com), prefer calling it through the catalog so credentials are managed centrally.

L2: Procedure

1. Build the request

curl -s --max-time 15 --ssl-no-revoke \
  "https://api.map.baidu.com/place/v2/search?query={company-name-URL-encoded}&region={city-or-nationwide}&output=json&page_size=20&ak=${BAIDU_MAP_AK}"

Parameters:

Param	Value	Notes
query	Company name (URL-encoded)	e.g. `华为技术有限公司` → `%E5%8D%8E%E4%B8%BA%E6%8A%80%E6%9C%AF%E6%9C%89%E9%99%90%E5%85%AC%E5%8F%B8`
region	City name or `全国` (nationwide)	Scope; use nationwide when unsure
output	json	Fixed
page_size	20	Max 20 per page
ak	`{BAIDU_MAP_AK}`	Baidu Map AK (free for individual developers)

2. Interpret the response

status == 0: success, extract results[]
status != 0: failure, check message (101 = AK missing, 200 = AK disabled, 302 = quota exceeded)

3. Normalized mapping

Map each entry in results[] to:

{
  "source": "baidu-poi",
  "company_name": "{user input}",
  "poi_name": "{result.name}",
  "address": "{result.address}",
  "latitude": "{result.location.lat}",
  "longitude": "{result.location.lng}",
  "province": "{result.province}",
  "city": "{result.city}"
}

4. Homonym filtering (due-diligence scenario)

POI results may contain same-name noise (e.g. "南岗华为公司" is not "华为技术有限公司"). Filtering suggestion:

Exact match: result.name equals the full company name → match=exact
Partial match: result.name contains the full name or its short name → match=partial
Otherwise → match=related, listed separately in due-diligence reports

5. Output format

{
  "query_status": "success",
  "source": "baidu-poi",
  "total": 5,
  "results": [
    { "poi_name": "华为技术有限公司", "address": "广东省深圳市龙岗区...", "latitude": "22.656137", "longitude": "114.066131", "match": "exact" }
  ],
  "timestamp": "2026-08-31T21:00:00+08:00"
}

Known Limitations

Free quota: QPS (~3/s) and daily caps (~100 place-search calls/day) for individual developers, per console quota management
POI ≠ registered business address: results are map annotations and may differ from the registered address (note the distinction in due diligence)
Homonyms: short names of famous companies hit many non-target POIs — prefer the full company name

Troubleshooting

Code	Meaning	Fix
0	Success	—
101	AK param missing	Check the ak parameter
200	AK disabled	Check app status in the Baidu console
201	AK/SN check failed	This recipe uses an empty-whitelist `0.0.0.0/0` AK; no SN needed
302	Quota exceeded	Wait for the daily reset or upgrade the quota
240	API service invalid	The AK has not enabled "Place Search" — fix the app in the console

5.9 KiB Raw Blame History