mirror of https://git.openapi.site/https://github.com/desirecore/market.git synced 2026-09-05 20:03:43 +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

6.6 KiB

Raw Blame History

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

name

description

version

type

risk_level

status

Tianyancha Risk Query

L0: One-Sentence Summary

Input a company name, call the Tianyancha risk-info API, and return a structured risk profile (self / related-party / historical / warning, four categories).

L1: Overview

Data source: Tianyancha Open Platform risk/riskInfo/2.0
Auth: Token (Authorization header, without the Bearer prefix)
Invocation: HTTP GET (curl / HttpRequest tool)
Prerequisites: a valid Token with the risk API enabled

Credential Setup

This skill requires a Tianyancha Open Platform Token:

Register an enterprise account at the Tianyancha Open Platform
Purchase/enable an API package (risk/riskInfo/2.0 is authorized per package tier)
Export the token as the environment variable TIANYANCHA_TOKEN, or replace the {TIANYANCHA_TOKEN} placeholder below

L2: Procedure

1. Build the request

curl -s --max-time 30 --ssl-no-revoke \
  "https://open.api.tianyancha.com/services/open/risk/riskInfo/2.0?keyword={company-name-URL-encoded}" \
  -H "Authorization: ${TIANYANCHA_TOKEN}"

Parameters:

Param	Value	Notes
keyword	Company name (URL-encoded)	e.g. `华为技术有限公司`
Authorization	`{TIANYANCHA_TOKEN}`	Token in header, no `Bearer` prefix (adding one returns 300009)

2. Interpret the response

error_code == 0 and reason == "ok": success, extract result.riskList[]
error_code == 300009: account error — wrong token or a Bearer prefix was added
error_code == 300005: no permission for this API — the token does not cover it
error_code == 300008: missing parameter — check keyword

3. Response structure

result contains:

riskLevel: overall risk level
riskList[]: four risk categories (each with name / count / type / list[])

Category	type	Meaning
Self risk	1	The company's own judicial/business risks (court hearings / rulings / case filings / court announcements / judicial auctions)
Related-party risk	2	Risks of shareholders, executives, invested companies
Historical risk	3	Closed historical risks (historical filings / hearings / dishonest-debtor history)
Early warnings	0	Business-registration changes (investor / key-personnel / registered-capital / legal-representative changes, bankruptcy cases)

Each category's list[] holds sub-items with title (e.g. "开庭公告") / total / tag (warning / high-risk / info) / list[] (top details with id / title / desc / riskCount).

4. Normalized mapping

{
  "query_status": "success",
  "source": "tianyancha",
  "company_name": "{company name}",
  "risk_level": "{result.riskLevel}",
  "summary": {
    "self_risk_count": 3127,
    "related_risk_count": 1505,
    "history_risk_count": 9113,
    "warning_count": 815
  },
  "self_risks": [
    { "risk_type": "开庭公告", "count": 1501, "level": "警示", "title": "该公司起诉他人或公司的开庭公告", "detail_count": 1096 }
  ],
  "timestamp": "2026-08-31T21:00:00+08:00"
}

5. Due-diligence highlights

Prioritize as follows when composing the report:

High-risk entries (tag=高风险): e.g. "被执行人", "清算信息", "失信被执行人" — list as major risk items
Large warning counts (total > 100): e.g. 1,501 hearing announcements — list as judicial-activity indicators
Change warnings: recent investor / legal-representative / capital changes — list as business dynamics

Known Limitations

Tiered token authorization: APIs are authorized per package; unauthorized APIs return 300005 — full-dimension packages unlock business/shareholder/IP endpoints
QPS throttling: rate limits depend on the package; keep ≥1 s between calls
Large responses: big companies can return 98KB+ — extract summaries plus top-N details to keep context small

Troubleshooting

Code	Meaning	Fix
0	Success	—
300005	No permission for this API	Confirm the endpoint is covered by your package
300008	Missing parameter	Check the keyword parameter
300009	Account error	Wrong token / Bearer prefix / expired token — remove the prefix and retry; if still failing, update the token

6.6 KiB Raw Blame History Unescape Escape