# 使用 Homebrew 安装 hq

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

## 安装

```sh
sudo av install brew:hq
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install hq
```

  证据: local Homebrew formula metadata

## 软件包事实

- **软件包键:** brew:hq
- **软件包管理器:** Homebrew
- **软件包管理器页面:** <https://formulae.brew.sh/formula/hq>
- **版本:** 1.2.2
- **来源摘要:** Jq, but for HTML
- **主页:** <https://orf.github.io/html-query/>
- **仓库:** <https://github.com/orf/html-query>
- **上游文档:** <https://github.com/orf/html-query#readme>
- **许可证:** MIT
- **源码归档:** <https://github.com/orf/html-query/archive/refs/tags/html-query-v1.2.2.tar.gz>
- **最后更新:** 2026-06-15T10:20:18-04:00
- **已生成:** 2026-07-25T07:20:51+00:00

## 可执行文件

- hq (cli)
- hq (别名)

## 构建依赖

- rust

## 安装行为

- post-install 钩子: 未定义
- Bottle: 可用 于 arm64_linux, arm64_monterey, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, monterey, sonoma, ventura, x86_64_linux

## 版本和新鲜度

- 页面生成时间: 2026-07-25
- 管理器版本: 1.2.2
- 管理器更新时间: 2026-06-15
- 本地数据: OK
- 上游仓库: https://github.com/orf/html-query
- 信息: No cached GitHub release or tag data was available.
## 项目历史与用法

hq is a Rust command-line tool for extracting structured JSON from HTML with CSS selectors. Its README summarizes the idea as `jq, but for HTML`.

### 项目历史

The project lives in the `orf/html-query` repository as a small Rust workspace with crates for the CLI, AST, extractor, and web UI. The README documents a selector syntax that looks JSON-shaped but uses CSS selectors as values, then emits JSON output.

### 采用历史

hq is packaged through Homebrew and published on crates.io as `html-query`. The crates.io metadata records the crate creation in December 2022 and points back to the upstream repository lineage, while the README documents installation through either `brew install hq` or `cargo install html-query`.

### 使用方式

Users pass hq a query such as `{posts: .athing | [{title: .titleline > a}]}` to select HTML elements and shape the result as JSON. The documented syntax includes text extraction, attribute extraction, parent selection, sibling selection, and nested arrays or objects.

The common use case is quick shell scraping: fetch or pipe HTML, select useful pieces with CSS selectors, and hand the resulting JSON to other command-line tools.

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

hq is interesting because it imports the jq mental model into HTML scraping without trying to become a full crawler or browser automation framework. For package nerds, it belongs to the small-tool lineage where each file format gets a composable query command.

It also shows a familiar Rust CLI distribution pattern: a crates.io package for Cargo users, a GitHub repository with a web demo, and a Homebrew formula for users who want a binary package.

### 时间线

- 2022: crates.io records the `html-query` crate creation.
- 2023: crates.io records version 1.2.2 of `html-query`.
- 1.2.2: Homebrew packages hq from the upstream `html-query-v1.2.2` GitHub archive.

### Related projects

- jq is the direct conceptual comparison used in the hq README.
- CSS selector engines and Rust HTML parsing crates provide the underlying interaction model.
- htmlq is a related but separate CLI in the broader `jq for HTML` family.

### 来源

- <https://crates.io/crates/html-query>
- <https://formulae.brew.sh/formula/hq>
- <https://github.com/orf/html-query>
- <https://orf.github.io/html-query>


## 安全说明

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


## 源数据库详情

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** hq
- **Version Scheme:** 0
- **Revision:** 0
- **Conflicts With:** proxygen
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable


## 相关链接

- [Source-control packages](https://www.automicvault.com/zh-hans/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/zh-hans/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/zh-hans/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/zh-hans/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [rust](https://www.automicvault.com/zh-hans/pkg/brew/rust/) - Build dependency declared by Homebrew.
- [htmlq](https://www.automicvault.com/zh-hans/pkg/brew/htmlq/) - Shares av.db curated category or tags: cli, css-selectors, developer-tools, html, scraping.
- [cascadia](https://www.automicvault.com/zh-hans/pkg/brew/cascadia/) - Shares av.db curated category or tags: cli, css-selectors, developer-tools, html.
- [htmlcleaner](https://www.automicvault.com/zh-hans/pkg/brew/htmlcleaner/) - Shares av.db curated category or tags: cli, developer-tools, html, parser.
- [htmlcxx](https://www.automicvault.com/zh-hans/pkg/brew/htmlcxx/) - Shares av.db curated category or tags: cli, developer-tools, html, parser.
- [jshon](https://www.automicvault.com/zh-hans/pkg/brew/jshon/) - Shares av.db curated category or tags: cli, developer-tools, json, parser.
- [jsonlint](https://www.automicvault.com/zh-hans/pkg/brew/jsonlint/) - Shares av.db curated category or tags: cli, developer-tools, json, parser.
- [libfyaml](https://www.automicvault.com/zh-hans/pkg/brew/libfyaml/) - Shares av.db curated category or tags: cli, developer-tools, json, parser.
- [libxml2](https://www.automicvault.com/zh-hans/pkg/brew/libxml2/) - Shares av.db curated category or tags: cli, developer-tools, html, parser.
- [minify](https://www.automicvault.com/zh-hans/pkg/brew/minify/) - Both packages work with overlapping file formats or content types. Shared terms: cli, css, developer, developer-tools, html.

## Combined YAML source

View the package source record on GitHub. [combined/hq.yml](https://github.com/automic-vault/db/blob/main/combined/hq.yml)


## 来源

- Nucleus package database
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
