# 使用 Homebrew 安装 twarc

查看 twarc 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:twarc
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install twarc
```

  证据: local Homebrew formula metadata

## 软件包事实

- **软件包键:** brew:twarc
- **软件包管理器:** Homebrew
- **版本:** 2.14.1
- **来源摘要:** Command-line tool and Python library for archiving Twitter JSON
- **主页:** <https://github.com/DocNow/twarc>
- **最后更新:** 2026-05-15T11:13:46Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- twarc (别名)
- twarc2 (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 2.14.1
## 项目历史与用法

twarc is a command-line tool and Python library from the Documenting the Now ecosystem for collecting and archiving Twitter JSON data through the Twitter API. In package-manager culture it sits at the intersection of social-media research, archival practice, and reproducible command-line data collection.

### 项目历史

The project was developed under DocNow with Mellon Foundation support, and its README defines its purpose narrowly: collection and archiving of Twitter data through the API. The project eventually exposed two command families: `twarc` for the older Twitter API v1.1 surface and `twarc2` for Twitter API v2 and Academic Access.

In 2021 DocNow announced twarc2 as a ground-up redesign for Twitter API v2 and the Academic Research track. The redesign responded to changes in Twitter's data model, rate limits, and full-archive access, while keeping the old v1.1-oriented command available for users who still depended on it.

The repository now notes that twarc is no longer actively supported after Twitter API quota changes made it unusable for its original research and archiving workflows.

### 采用历史

twarc was adopted by researchers, archivists, journalists, and digital-humanities users who needed a repeatable way to collect Twitter data as JSON without writing their own API client. The official tutorial is aimed at researchers new to command-line social-media data collection and walks through search, JSON output, CSV conversion, and sharing tweet identifier datasets.

The twarc2 release notes describe a community around the tool, including code and design contributors and early feedback from researchers and practitioners. That community use case was shaped by the Twitter Academic Research track, which opened full-history search to approved researchers before later API changes reduced the tool's practical usefulness.

### 使用方式

Common package-nerd usage is installing the CLI, configuring Twitter/X developer credentials, and running commands such as `twarc2 search ... > tweets.jsonl` or using twarc as a Python library. The tool stores tweet data as line-oriented JSON and delegates rate-limit handling and high-fidelity v2 field expansion to the library.

twarc also became a base for small data-processing plugins. The README explicitly points users with use-case-specific needs toward external packages that hook into `twarc2` through `click-plugins`, keeping the core tool focused on acquisition and archival JSON.

### 为什么软件包爱好者会关心

twarc matters to package nerds because it turned a fragile web-API workflow into a packaged, scriptable Unix-style tool: install it, configure credentials, stream JSON, and compose the result with CSV converters, Python, pandas, jq, and archival pipelines.

Its history also records a hard lesson for API-dependent packages: a well-packaged tool can be technically sound and widely used, yet still be constrained or broken by upstream platform policy and quota changes.

### 时间线

- 2010s: twarc becomes a DocNow tool for collecting and archiving Twitter JSON through the Twitter API.
- 2021-04-07: DocNow announces twarc2, redesigned for Twitter API v2 and Academic Research access.
- 2020s: twarc documents separate `twarc` and `twarc2` commands for Twitter API v1.1 and v2 workflows.
- 2020s: The repository notes that Twitter API quota changes left twarc no longer actively supported.

### Related projects

- DocNow and the Documenting the Now project provided the institutional setting for twarc.
- twarc-csv and other twarc2 plugins extend collected JSON into analysis-friendly formats.
- Twitter/X API v1.1, Twitter/X API v2, and the Academic Research track shaped the tool's command design and adoption.

### 来源

- DocNow project post, 'twarc2', 2021-04-07: https://medium.com/documenting-docnow/twarc2-779278e66ea0
- GitHub README: https://github.com/DocNow/twarc
- Official documentation tutorial: https://twarc-project.readthedocs.io/en/latest/tutorial/
- Official twarc2 documentation: https://twarc-project.readthedocs.io/en/latest/twarc2_en_us/


## 安全说明

没有找到 twarc 的匹配本地密钥处理 manifest。Nucleus 软件包元数据仍在此发布，以便未来覆盖拥有稳定的软件包 URL。



## Combined YAML source

View the package source record on GitHub. [combined/twarc.yml](https://github.com/mxcl/pkgdb/blob/main/combined/twarc.yml)


## 来源

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- cross-ecosystem install command graph
