rly0nheart/pyahmia
GitHub: rly0nheart/pyahmia
这是一个基于 Python 的命令行工具,旨在通过 Ahmia.fi 索引快速搜索并导出 Tor 网络中的隐藏服务链接。
Stars: 12 | Forks: 3

**PyAhmia** 使用 Ahmia.fi 在 Tor 网络上搜索与指定查询匹配的隐藏服务,而无需显式要求 Tor。






## 功能
- [x] 从命令行搜索 Ahmia.fi
- [x] 将结果导出为 CSV
- [x] 启用/禁用通过 Tor 路由请求
- [x] 以清晰可读的格式返回结果
- [x] 响应缓存以加快重复搜索
- [x] 可配置的结果限制和请求超时
## 安装
**PyAhmia** 可在 PyPI 上获取,并可以像这样安装:
```
pip install pyahmia
```
这将安装 `ahmia` 和 `pyahmia` 作为命令。
## 使用
要开始搜索,你可以使用指定的搜索查询调用 `ahmia`(或 `pyahmia`)。
*示例*:
```
ahmia QUERY
```
### 通过 Tor 路由流量(可选)
**PyAhmia 可以在没有 Tor 的情况下工作,但如果你愿意,可以启用通过 Tor 路由流量。**
启用此功能后,它将使用 Ahmia 的暗网 URL 而不是明网版本。
要启用通过 Tor 的路由,你可以使用 `-t, --use-tor` 标志调用 `ahmia`。
这假设 tor 服务正在后台运行,否则,命令会在你来不及说 "hidden wiki" 之前就失败。
如果未安装 Tor,你可以查看位于 [pyahmia/scripts](https://github.com/rly0nheart/pyahmia/tree/master/scripts) 的安装脚本。
*示例*:
```
ahmia QUERY --use-tor
```
### 导出输出
PyAhmia 目前仅支持将数据导出到 csv 文件,为了导出,你需要指定 `-e, --export` 标志。
这将把你的搜索结果导出到以你的搜索查询命名的文件中。
*示例*:
```
ahmia QUERY --export
```
### 按时间段过滤结果
结果可以按 3 个时间段(天、周、月)过滤。默认情况下,结果将取自所有时间段。你可以使用 `-p, --period` 选项来更改此设置,并传递你想要获取结果的时间段。
*示例*:
```
ahmia QUERY --period week
```
### 限制结果
默认情况下,PyAhmia 最多显示 100 个结果。你可以使用 `-l, --limit` 选项更改此设置。
*示例*:
```
ahmia QUERY --limit 50
```
要显示所有结果而不受限制,请使用 `-a, --all` 标志。
*示例*:
```
ahmia QUERY --all
```
### 缓存
PyAhmia 默认缓存响应以减少冗余请求。要禁用缓存,请使用 `--no-cache` 标志。
*示例*:
```
ahmia QUERY --no-cache
```
### 请求超时
你可以使用 `--timeout` 选项为请求设置自定义超时(以秒为单位)。默认为 10 秒。
*示例*:
```
ahmia QUERY --timeout 30
```
## 结语
不要使用 pyahmia 发送太多请求。请善待 Ahmia.fi 的所有者 :)
## 许可证
本项目在 MIT 许可证下获得许可,详情请参阅 [LICENSE](https://codeberg.org/rly0nheart/pyahmia/raw/branch/master/LICENSE) 文件。
标签:Ahmia.fi, CLI, CSV, ESC4, OSINT, PyAhmia, Python, Tor代理, Tor网络, WiFi技术, 响应缓存, 开源, 搜索引擎, 数据导出, 文档结构分析, 无后门, 暗网, 洋葱服务, 流量路由, 网络安全, 逆向工具, 隐私保护, 隐秘服务搜索