Photon README

The project's README from github.com/s0md3v/Photon. As one markdown file: README.md.


Photon
Photon

Incredibly fast crawler designed for OSINT.

pypi

Photon Wiki • How To Use • Compatibility • Photon Library • Contribution • Roadmap

Key Features

Data Extraction

Photon can extract the following data while crawling:

The extracted information is saved in an organized manner or can be exported as json.

save demo

Flexible

Control timeout, delay, add seeds, exclude URLs matching a regex pattern and other cool stuff. The extensive range of options provided by Photon lets you crawl the web exactly the way you want.

Genius

Photon's smart thread management & refined logic gives you top notch performance.

Still, crawling can be resource intensive but Photon has some tricks up it's sleeves. You can fetch URLs archived by archive.org to be used as seeds by using --wayback option.

Plugins

Docker

Photon can be launched using a lightweight Python-Alpine (103 MB) Docker image.

$ git clone https://github.com/s0md3v/Photon.git
$ cd Photon
$ docker build -t photon .
$ docker run -it --name photon photon:latest -u google.com

To view results, you can either head over to the local docker volume, which you can find by running docker inspect photon or by mounting the target loot folder:

$ docker run -it --name photon -v "$PWD:/Photon/google.com" photon:latest -u google.com

Frequent & Seamless Updates

Photon is under heavy development and updates for fixing bugs. optimizing performance & new features are being rolled regularly.

If you would like to see features and issues that are being worked on, you can do that on Development project board.

Updates can be installed & checked for with the --update option. Photon has seamless update capabilities which means you can update Photon without losing any of your saved data. Use Control + Shift + m to toggle the tab key moving focus. Alternatively, use esc then tab to move to the next interactive element on the page. Attach files by dragging & dropping, selecting or pasting them. (https://www.thordata.com/?ls=github&lk=Photon)

demo

Photon Wiki • How To Use • Compatibility • Photon Library • Contribution • Roadmap

Key Features

Data Extraction

Photon can extract the following data while crawling:

The extracted information is saved in an organized manner or can be exported as json.

save demo

Flexible

Control timeout, delay, add seeds, exclude URLs matching a regex pattern and other cool stuff. The extensive range of options provided by Photon lets you crawl the web exactly the way you want.

Genius

Photon's smart thread management & refined logic gives you top notch performance.

Still, crawling can be resource intensive but Photon has some tricks up it's sleeves. You can fetch URLs archived by archive.org to be used as seeds by using --wayback option.

Plugins

Docker

Photon can be launched using a lightweight Python-Alpine (103 MB) Docker image.

$ git clone https://github.com/s0md3v/Photon.git
$ cd Photon
$ docker build -t photon .
$ docker run -it --name photon photon:latest -u google.com

To view results, you can either head over to the local docker volume, which you can find by running docker inspect photon or by mounting the target loot folder:

$ docker run -it --name photon -v "$PWD:/Photon/google.com" photon:latest -u google.com

Frequent & Seamless Updates

Photon is under heavy development and updates for fixing bugs. optimizing performance & new features are being rolled regularly.

If you would like to see features and issues that are being worked on, you can do that on Development project board.

Updates can be installed & checked for with the --update option. Photon has seamless update capabilities which means you can update Photon without losing any of your saved data.

Contribution & License

You can contribute in following ways:

Please read the guidelines before submitting a pull request or issue.

Do you want to have a conversation in private? Hit me up on my twitter, inbox is open :)

Photon is licensed under GPL v3.0 license

Photon (s0md3v/Photon)

Searching Database…

13.3K ·GitHub
这是什么?Photon 是一个快速的网络爬虫,专为 OSINT(开源情报)收集而设计。它在爬取目标网站的同时,提取 URL、电子邮件、社交媒体账号、密钥和子域名等信息。
这是函数库还是命令行工具?这是一个 Python 命令行爬虫,需要针对目标 URL 运行,而不是可以导入到代码中的函数库。
我该怎么运行它?可以把它作为 Python 脚本运行并指定目标,也可以通过官方轻量级的 Python-Alpine Docker 镜像启动,然后在挂载的 loot 文件夹中查看结果。
除了 Python,使用它还需要别的东西吗?只需要 Python 来运行脚本;如果你更喜欢容器化版本,也可以用 Docker。基本爬取不需要 API 密钥。
爬取会占用大量资源吗?会的。Photon 依靠智能线程管理来保持速度,但 README 本身也指出,在大型目标上爬取仍可能非常占用资源。
Photon 在爬取时能提取哪些数据?它可以提取范围内和范围外的 URL、带参数的 URL、电子邮件和社交媒体账号等情报、文件(pdf、png、xml 等)、密钥和 API 密钥、JavaScript 文件及其端点、自定义正则匹配结果,以及子域名和 DNS 数据。结果可以整理保存,也可以导出为 JSON。
Photon 的插件有什么用?内置插件包括 wayback(从 archive.org 拉取存档 URL 作为种子)、dnsdumpster,以及用于保存结果的 Exporter。
我如何让 Photon 保持最新?使用 --update 选项运行即可。它会检查并安装更新,且不会丢失已保存的爬取数据。
我为什么要使用 --wayback 选项?它会获取 archive.org 存档的 URL 作为额外种子,帮助 Photon 发现那些在网站上已经不再直接链接的页面。
Creator
s0md3v
Size
0.3 MB
Stars
13.3K
Age
8y
Commits · 90 Days