{"id":26820387,"url":"https://github.com/zvdy/parsero-go","last_synced_at":"2025-03-30T06:32:08.469Z","repository":{"id":257814287,"uuid":"867216185","full_name":"zvdy/parsero-go","owner":"zvdy","description":"Parsero is a free script written in Golang which reads the Robots.txt file of a web server and looks at the Disallow entries. The Disallow entries tell the search engines what directories or files hosted on a web server mustn't be indexed.","archived":false,"fork":false,"pushed_at":"2025-01-02T20:01:04.000Z","size":29525,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-02T20:31:48.384Z","etag":null,"topics":["cybersecurity","golang","http","robots-txt"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/repository/docker/zvdy/parsero/general","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zvdy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-10-03T16:45:51.000Z","updated_at":"2025-01-02T20:00:00.000Z","dependencies_parsed_at":"2024-10-08T09:22:12.830Z","dependency_job_id":"9a57f3d6-1f2d-4589-9049-22418cbecbff","html_url":"https://github.com/zvdy/parsero-go","commit_stats":null,"previous_names":["zvdy/parsero-go"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zvdy%2Fparsero-go","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zvdy%2Fparsero-go/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zvdy%2Fparsero-go/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zvdy%2Fparsero-go/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zvdy","download_url":"https://codeload.github.com/zvdy/parsero-go/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246285645,"owners_count":20752947,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cybersecurity","golang","http","robots-txt"],"created_at":"2025-03-30T06:31:47.932Z","updated_at":"2025-03-30T06:32:08.463Z","avatar_url":"https://github.com/zvdy.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Parsero\n\n[![Go Report Card](https://goreportcard.com/badge/github.com/zvdy/parsero-go)](https://goreportcard.com/report/github.com/zvdy/parsero-go)\n\nParsero is a free script written in Golang which reads the Robots.txt\nfile of a web server and looks at the Disallow entries. The Disallow\nentries tell the search engines what directories or files hosted on a\nweb server mustn't be indexed. For example, \"Disallow: /portal/login\"\nmeans that the content on www.example.com/portal/login it's not allowed\nto be indexed by crawlers like Google, Bing, Yahoo... This is the way\nthe administrator have to not share sensitive or private information\nwith the search engines.\n\nBut sometimes these paths typed in the Disallows entries are directly\naccessible by the users without using a search engine, just visiting\nthe URL and the Path, and sometimes they are not available to be visited\nby anybody. Because it is really common that the administrators write\na lot of Disallows and some of them are available and some of them are\nnot, you can use Parsero in order to check the HTTP status code of each\nDisallow entry in order to check automatically if these directories are\navailable or not.\n\nAlso, the fact the administrator write a robots.txt, it doesn't mean\nthat the files or directories typed in the Dissallow entries will not\nbe indexed by Bing, Google, Yahoo, etc. For this reason, Parsero is\ncapable of searching in Bing to locate content indexed without the web\nadministrator authorization. Parsero will check the HTTP status code in\nthe same way for each Bing result.\n\nWhen you execute Parsero, you can see the HTTP status codes. For example,\nthe codes bellow:\n\n    200 OK          The request has succeeded.\n    403 Forbidden   The server understood the request, but is refusing to fulfill it.\n    404 Not Found   The server hasn't found anything matching the Request-URI.\n    302 Found       The requested resource resides temporarily under a different URI.\n    ...\n\n\n## Installation\nTo install Parsero, you need to have Golang installed on your machine. You can download and install Golang from [here](https://golang.org/dl/).\n\nOnce you have Golang installed, you can install Parsero by running the following command:\n\n```sh\ngo get -u github.com/zvdy/parsero-go\n```\n\n## Usage\nYou can run Parsero using the following command:\n\n```sh\nparsero --url \u003cURL\u003e [--only200] [--searchbing] [--file \u003cFILE\u003e]\n```\n\nOptions:\n- `--url`: Type the URL which will be analyzed.\n- `--only200`: Show only the 'HTTP 200' status code.\n- `--searchbing`: Search in Bing indexed Disallows.\n- `--file`: Scan a list of domains from a list.\n\nExample:\n```sh\nparsero --url http://example.com --only200\n```\n\n## Terminal Session Example\n\nYou can watch a recorded terminal session here:\n\n[![asciinema recording](https://asciinema.org/a/Vd0kE9zVyPPwqLNjsEGDr4IZg.png)](https://asciinema.org/a/Vd0kE9zVyPPwqLNjsEGDr4IZg)\n\n\n## Docker Setup\n\nYou can use the [Dockerfile](Dockerfile) in the root of the repository in order to build parsero as a container. \n\n### Step-by-Step Docker Setup\n\n\n1. **Build the Docker Image**:\n   Open a terminal in the root of your project directory and run the following command to build the Docker image:\n\n   ```sh\n   docker build -t parsero:latest .\n   ```\n\n2. **Run the Docker Container**:\n   After building the image, you can run it using the following command:\n\n   ```sh\n   docker run -it --rm parsero:latest --url http://example.com --only200\n   ```\n\n### Docker Hub\n\nYou can retrieve the image directly from Docker hub too.\n\n   ```sh\n   docker pull zvdy/parsero:latest\n   docker run -it --rm zvdy/parsero:latest --url http://example.com --only200\n   ```\n\n## License\nThis project is licensed under the MIT. See the [LICENSE](LICENSE) file for details.\n\n## Contributing\nContributions are welcome! Please open an issue or submit a pull request for any changes.\n\n### Acknowledgements\nThis project is a port of [parsero](https://github.com/behindthefirewalls/Parsero) which is written in Python, the repository ports it to Golang in order to optimize the speed in long `robots.txt` files.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzvdy%2Fparsero-go","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzvdy%2Fparsero-go","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzvdy%2Fparsero-go/lists"}