logos-bancos-br

这是一个包含巴西金融机构和支付机构徽标的数据集，涵盖银行、金融科技公司、支付机构和合作社。数据源自三个官方来源：巴西中央银行的STR参与者名单、活跃Pix参与者名单以及巴西开放金融目录。数据集每周自动更新，提供徽标的可验证来源，包括机构名称、ISPB、CNPJ和参与Pix的属性，并包含徽标图像文件。This is a dataset comprising logos of Brazilian financial and payment institutions, covering banks, fintech companies, payment service providers, and cooperatives. The data is sourced from three official channels: the list of STR participants from the Central Bank of Brazil, the list of active Pix participants, and the Brazilian Open Finance Directory. The dataset is automatically updated weekly, providing verifiable sources for the logos, including the institution's name, ISPB, CNPJ, Pix participation attribute, and the logo image files.

原始信息汇总

数据集概述：logos-bancos-br

该数据集提供巴西金融机构和支付机构的标识（Logo）列表，数据来源于巴西中央银行（Banco Central do Brasil）和开放金融巴西（Open Finance Brasil）的官方渠道。

核心内容

• 机构列表：包含一个主列表和一个独立子集。
  • 主列表 (data/bancos.json)：包含 470 家拥有 COMPE 代码的机构，信息源自巴西中央银行的 STR 参与者列表。
  • 独立子集 (data/instituicoes-pix.json)：包含 643 家仅参与 Pix 的机构（如金融科技公司、IP 和附属合作社），无 COMPE 代码。
• 标识（Logo）：
  • 共为 473 家机构提供了标识，共使用 160 个不同的图像文件（约 1.7 MB）。
  • 附属机构的标识遵循品牌共享规则（如 Sicoob、Sicredi），共享单个文件。
  • 标识来源包括开放金融巴西的公共目录（openfinance）或机构官方网站（direct-uri）。
• 数据格式：提供 JSON 格式的数据文件，包含机构名称、ISPB、CNPJ 及 Pix 参与属性。
• 更新频率：数据通过 CI/CD 流程每周自动更新，确保与官方来源同步。

数据来源与可靠性

• 官方源：所有数据均来自三个指定的官方来源：
  1. 巴西中央银行 - STR 参与者列表：提供 ISPB、COMPE 代码和官方名称。
  2. 巴西中央银行 - 活跃 Pix 参与者列表：补充 Pix 相关机构及其属性。
  3. 开放金融巴西 - 参与者目录：提供机构发布的官方标识。
• 可追溯性：每个标识文件都记录了来源 URI、SHA-256 哈希值和更新日期，确保可审计。
• 匹配逻辑：使用ISPB（与 CNPJ 前 8 位数字一致）进行精确匹配，避免因名称相似导致的错误。

使用方式与技术栈支持

该数据集提供多种使用方式，支持跨平台开发：

• npm 包：提供 JavaScript/TypeScript API，可用于 Node.js 和 Web 环境。
• React Native：提供静态 require() 映射，方便集成。
• 命令行工具 (CLI)：支持将资产导出到 Flutter、Kotlin、Swift、.NET、PHP 等项目中。
• CDN：可直接通过 jsDelivr 引用标识文件，无需安装任何依赖。
• 纯 JSON 数据：可直接导入数据文件使用。

数据字段示例

一个典型的数据记录包含以下字段：

字段	说明
ispb	8 位 ISPB 代码（稳定唯一标识符）
compe	COMPE 代码（存在于主列表中）
name	机构官方名称
pix	Pix 参与属性（如参与类型、模式等）
logo.png	PNG 格式标识路径（256x256，透明背景）
logo.svg	SVG 格式标识路径（原始矢量图形）
logo.source	标识来源信息（类型、来源 URI、SHA-256 哈希、更新日期）

已知限制

• 标识覆盖率：1,113 家机构中，473 家拥有标识。无标识的机构通常为小型 SCD、经纪商或 IP。
• 产品品牌标识：部分机构在目录中发布的标识为其产品品牌（如银行发布联名卡标识）。
• 数据排除：正在加入 Pix 的机构或无 ISPB 的参与者未被收录。

搜集汇总

数据集介绍

构建方式

该数据集的构建基于巴西中央银行官方发布的STR参与者列表与Pix活跃参与者列表，以及Open Finance Brazil的参与者目录，三套官方数据源每周经由GitHub Actions自动重建。通过ISPB（即CNPJ前八位）进行机构匹配，确保标识符稳定且唯一。对于拥有自有标识的机构，其图标从Open Finance公开目录或机构官方网站获取；隶属于单一品牌合作系统（如Sicoob、Sicredi）的附属机构共用一套图档，以精简存储。所有图档均经过SHA-256校验、像素与大小限制等安全性清洗流程，并记录来源URI与更新时间，构建流程人工审核后以拉取请求方式合并发布。

特点

该数据集核心特点在于数据来源的官方性与可验证性，完全排除网络爬取或无溯源信息。473家机构图标来自160个独立图档，涵盖主要银行与支付机构，并通过品牌标识与自有图标分类管理。数据集持续更新，每周自动运行工作流，确保列表与图标随央行调整即时变化。图标以透明背景256×256像素PNG格式交付，安全向量SVG亦可同步获取，每份资源均附带完整来源记录，支持审计追踪。此外，数据集区分主表（含COMPE代码）与仅Pix机构表，兼顾精简与详实。

使用方法

用户可通过npm安装该JavaScript/TypeScript包，在Node.js、Web或React Native环境中调用banks()、byCompe()、byIspb()等API按机构代码查询信息及CDN图标URL。React Native项目可导入预构建的静态映射，Flutter、Kotlin、Swift等非JavaScript栈则使用CLI命令将图标复制至本地资产目录。如需直接访问数据集，可导入JSON文件或使用CDN链接引用指定版本的图标。所有查询均兼容四位数COMPE代码与八位数ISPB，确保无代码机构亦能被覆盖，零运行时依赖且易集成。

背景与挑战

背景概述

在巴西金融体系快速数字化转型的背景下，金融科技公司、支付机构与传统银行数量激增，如何高效、准确地识别并展示这些机构的标识成为开发者面临的重要课题。logos-bancos-br数据集由独立开发者于2024年创建，旨在从巴西中央银行（STR和Pix参与者名单）以及开放金融巴西（Open Finance Brasil）目录等官方源头，自动提取并维护包含470家COMPE机构和643家纯Pix机构的高质量标识集合。该数据集通过每周自动更新的CI流程，确保标识与机构信息的实时性与可追溯性，为金融应用、支付系统及数据可视化领域提供了标准化、可信赖的基准资源，显著提升了巴西金融生态系统的互操作性与用户体验。

当前挑战

该数据集面临的核心挑战在于解决金融标识碎片化与动态更新的矛盾。领域层面，巴西金融机构数量庞大且类型多样（银行、金融科技、支付机构、信用合作社），各机构标识分散于不同官方平台，缺乏统一获取渠道，导致应用开发中普遍存在标识缺失、版本过时或来源不可靠的问题。构建过程中，需攻克三大难点：一是从开放金融目录、央行CSV及机构官网等多源异构数据中自动匹配标识，仅通过ISPB（CNPJ前8位）实现精准对应，避免名称相似性带来的误配；二是对SVG文件进行安全净化以消除跨站脚本威胁，并对合作系统（如Sicoob、Sicredi）的共享标识进行去重管理；三是处理非开放金融参与机构的标识获取，需依赖人工策展与视觉审查，在保证覆盖率的同时维护可审计的溯源链。

常用场景

经典使用场景

在巴西金融科技与开放银行生态蓬勃发展的背景下，logos-bancos-br数据集为开发者与研究者提供了一套完整且持续更新的巴西金融机构标识资源。其最经典的使用场景在于金融应用程序的用户界面构建，尤其是在需要展示收款方银行或支付机构徽标的转账、账单支付及Pix即时支付流程中。开发者通过该数据集提供的JavaScript API或CDN链接，仅需调用`logoCdnUrl`函数并传入银行代码，即可快速获取对应机构的高清PNG或SVG徽标，避免了手动收集与维护数上百家银行和金融科技公司图标的高昂成本。该数据集同时支持React Native环境，通过静态地图实现离线图标引用，确保了移动端应用的加载效率与一致性，成为构建巴西本土金融服务产品不可或缺的基础设施。

解决学术问题

该数据集巧妙解决了巴西金融机构标识数据分散、缺乏溯源机制和自动化更新等学术研究中的痛点问题。在金融普惠与支付系统比较分析领域，研究者以往需频繁从巴西中央银行STR列表、Pix参与机构名单及开放金融目录等多个官方来源手动聚合信息，而该数据集以ISPB（CNPJ前八位）为核心唯一标识，实现了三源数据的权威融合与结构化管理。其严格的审计机制——每枚徽标均记录来源URI、SHA-256哈希及采集日期——为复现性研究提供了可验证的数据凭证，使得关于机构标识更新频率、品牌策略演变或金融科技布局的地域分析得以在坚实的数据基础上展开。数据集对开放金融参与者与仅Pix机构的明确分类，亦为探讨巴西金融基础设施二元结构的研究提供了关键的分类变量。

衍生相关工作

该数据集衍生了一系列围绕巴西金融基础设施的经典后续工作。在数据管理与可视化层面，社区基于其结构化JSON开发了交互式机构搜索与徽标预览工具，如自动生成的完整图库页面（PREVIEW.md）为设计师提供了高效的品牌资源检索入口。在学术与方法论层面，研究者利用其自动化的CI/CD更新机制（每周一从巴西中央银行CSV重建）与Git差异审计功能，开创了金融机构标识变更模式的量化分析方法，例如追踪银行品牌重塑或并购后的徽标替换延迟。此外，该数据集的“品牌”徽标共享策略——同一合作系统（如Sicoob、Sicredi）的附属机构共用单一图标文件——启发了其他发展中国家构建层级化、低冗余的金融标识数据集，推动了关于如何平衡数据完整性、存储效率与语义精度的讨论，成为衡量金融数据工程最佳实践的重要参照。