如果你是“云居民”或数字游民，相信你对 Anytime Mailbox (ATMB) 一定不陌生。它是目前最流行的美国云信箱服务之一，提供了海量的美国地址供我们租赁使用。

但是，对于很多需要申请美国银行账户（如 Capital One, Chase 等）或注册美国券商账号的朋友来说，ATMB 最大的痛点在于：绝大多数地址都是“商业地址” (Commercial / CMRA)，而银行往往要求提供“住宅地址” (Residential / RDI)。

要在 ATMB 浩如烟海的地址列表中，手动一个个去查哪个是住宅地址，简直是大海捞针，费时费力。

为了解决这个问题，我写了一个开源的小程序：ATMB-Addresses。

这个工具能做什么？

简单来说，它就像一个自动化的“探针”，可以帮我们：

  1. 自动爬取 ATMB 上指定州（或全美）的所有地址信息。
  2. 自动识别 每个地址的属性，帮我们判断它究竟是 住宅 (Residential) 还是 商业 (Commercial) 地址。
  3. 整理成表，将结果保存为 Excel/CSV 文件，方便我们筛选。

如何使用（无需编程基础！）

虽然这是一个 Python 程序，但我知道很多朋友可能对代码并不熟悉。没关系！为了方便大家，我已经把爬取并验证好的现成数据直接上传到了仓库里。

如果你懒得自己跑程序，只需要直接下载我跑好的数据即可。

步骤如下：

  1. 访问我的 GitHub 仓库：https://github.com/masonblog/ATMB-Addresses
  2. 点击页面上的 “Public” 文件夹。
  3. 在里面找到你感兴趣的州（比如 new-york.csv 或 california.csv）。
  4. 下载这个 CSV 文件，用 Excel 打开。
  5. 在表格中寻找 rdi 这一列：
    • 如果显示 Residential，恭喜你！这很可能就是一个银行认可的住宅地址。
    • 如果显示 Commercial，那就是普通的商业地址。

就是这么简单！

进阶玩家：如何自己运行代码

如果你是技术党，或者你想获取最新的实时数据（毕竟地址库会更新），你也可以把代码下载到本地自己运行。

1. 准备工作

首先，你需要确保电脑上安装了 Python 3.x 环境，并安装必要的依赖库。在终端中运行以下命令：

pip install requests beautifulsoup4

其次，这个工具最核心的“验证”功能依赖于 Smarty API。你需要去 Smarty.com 注册一个账号（它提供免费1000条地址验证的试用额度，够我们跑很多数据了）。注册好后，获取你的 Auth ID 和 Auth Token，把它们保存好，后面会用到。

然后，访问我的 GitHub 仓库：https://github.com/masonblog/ATMB-Addresses，点击Code按钮，再点击Download ZIP打包下载代码。

Download_ZIP

在代码**根目录（解压后的文件夹）**下创建一个名为 smarty_api_key.txt 的文件，将刚刚保存的 Smarty API 的 Auth ID 和 Auth Token 填入这个文件并保存：

auth_id=你的AUTH_ID
auth_token=你的AUTH_TOKEN

2. 开始运行

整个流程分为三步：爬取 -> 补充详情（可选） -> 验证。

第一步：爬取基本地址信息

在代码文件夹右键单击，选择“在终端中打开”，然后输入以下命令运行 ATMB_scrape.py。你可以指定爬取某个州，或者直接爬取全美所有地址。

# 爬取纽约州
python ATMB_scrape.py --input new-york

# 爬取全美（耗时较长）
python ATMB_scrape.py --input us

程序运行后，会在 Public 文件夹下生成一个 CSV 文件，比如 Public/new-york.csv，里面包含了 ATMB 上最新爬取的地址信息，包括街道地址、城市、州、邮编等。

第二步：补充单元号信息（可选）

ATMB 的列表页通常只显示街道地址，但很多时候我们需要知道具体的单元号信息，比如 Suite # 或 Unit #。这一步就要在终端中输入以下命令，程序会访问每个地址的详情页，把这些信息抓取下来：

python ATMB_detail.py --input Public/new-york.csv

运行完成后，会生成一个新的文件 Public/new-york_detailed.csv。

第三步：验证地址性质（关键步骤）

最后，我们使用 Smarty API 来验证这些地址是住宅还是商业。在终端中运行以下命令：

python ATMB_verify.py --input Public/new-york_detailed.csv

程序会逐行验证，并生成最终的文件 Public/new-york_detailed_verified.csv。

打开这个最终文件，查看 rdi 列：

  • Residential: 住宅地址（银行喜欢这个！✅）
  • Commercial: 商业地址（⚠️）

详细的技术文档和使用参数，我都写在仓库的 README.md 里了，欢迎大家去 Star 和 Fork！

结语

寻找一个靠谱的美国住宅地址是很多“云居民”迈向全球化的第一步。希望这个小工具能帮你节省宝贵的时间，少走弯路。

如果你觉得好用，别忘了分享给身边有需要的朋友！