# metowolf/vCards

📡️ vCards 中国黄页 - 优化 iOS/Android 来电、信息界面体验

Repository: https://github.com/metowolf/vCards
Canonical: https://ross.abutalabs.com/products/vcards
Language: JavaScript
License Family: other
Topics: vcards, china, ios, macos
Last push: 2026-08-21T06:16:31+00:00

## Health v2 (maintenance only)
Score: 98/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 98, release rhythm 98, longevity 100
- inputs: {"age_days": 2633, "days_push": 12, "days_rel": 12, "gap_med": 7.5, "n_releases_24m": 5}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 6386, forks 312 (observed 2026-08-28T04:09:43.009012+00:00)

## What it is
A curated dataset of Chinese business and service contact vCards (with logos) that users import into iOS/macOS/Android address books via CardDAV or vcf files. It improves caller ID and messaging interfaces by showing recognized names and avatars for common Chinese phone numbers.

## Use cases
- show caller ID names for Chinese business numbers on iPhone
- import yellow pages contacts into iOS contacts
- subscribe to a CardDAV directory of China service numbers
- add avatars to incoming calls from unknown numbers
- self-host a CardDAV server with Chinese contact directory
- download vcf files of Chinese company contacts for iCloud

## When to choose
- you want recognized caller IDs for Chinese toll-free and service numbers on iOS or macOS
- you prefer a maintained, community-updated contact dataset with logos
- you want a CardDAV subscription that auto-updates contacts

## When to avoid
- you need caller ID outside China or for non-Chinese numbers
- you need spam blocking or call-filtering features rather than contact data
- you require a licensed codebase - the repo has no license

## Facets
- artifact type: dataset
- maturity: active
- function: data-generation, sdk
- domain: developer-tools, mobile-development
- platform: cross-platform
- tags: vcards, carddav, caller-id, contacts, yellow-pages, phone-numbers, china, ios, macos, android

## Member repositories
- metowolf/vCards (main) score 98

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:43.009012+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:45:03.787752+00:00, confidence not recorded.
  - readme: https://github.com/metowolf/vCards (fetched 2026-08-28T04:09:43.009012+00:00, sha b939aae91925)
- Data as of 2026-08-30T08:39:29.467469+00:00.