<p align=center>
<br>
<img width="70%" height="70%" src="https://raw.githubusercontent.com/PaPaPaulitos/sherlock-lib/master/images/sherlock-lib-logo.svg">
<br>
<span>A fork of the <a href="https://github.com/sherlock-project/sherlock">Sherlock Project</a></span>
<br>
<a href="https://github.com/sherlock-project/sherlock/blob/master/sites.md">List of social networks</a>
<br>
</p>
This library was created to use the Sherlock Project in your own personal scripts.
## Installation
```console
# installing using pip
$ pip install sherlock-lib
```
## Usage
```python
def search_target(username,timeout=60,sfw=False)
```
- **Username**: Target's name on social media
- **Timeout**: Maximum search time on each site
- **Safe for Work**: Remove NSFW(Not Safe for Work) sites
> This function returns a dictionary with the name of the sites and the link to the target's profile on the sites.
### Example
```python
from sherlock_lib import search_target
username = "john_doe"
result = search_target(username,sfw=True)
for k, v in result.items():
print(f"{k}: {v}")
```
## Contributing
We would love to have you help us with the development of Sherlock. Each and every contribution is greatly valued!
Here are some things we would appreciate your help on:
- Addition of new site support ¹
- Bringing back site support of [sites that have been removed](removed_sites.md) in the past due to false positives
[1] Please look at the Wiki entry on [adding new sites](https://github.com/sherlock-project/sherlock/wiki/Adding-Sites-To-Sherlock)
to understand the issues.
## License
- MIT © Sherlock Project<br/>
- Original Creator - [Siddharth Dushantha](https://github.com/sdushantha)
- Lib Creator - [Paulo Ricardo Mesquita](https://github.com/PaPaPaulitos)
Raw data
{
"_id": null,
"home_page": "",
"name": "sherlock-lib",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "sherlock,stalking,sherlock lib,sherlock-lib,stalking lib,stalking-lib,stalking with sherlock",
"author": "Paulo Ricardo Mesquita",
"author_email": "pauloricardomrs2002@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/6b/77/f41d75ede84574e7b409591e8f9b0ea195eb4281188fdf4413a44e9f325c/sherlock_lib-0.1.3.tar.gz",
"platform": null,
"description": "<p align=center>\r\n <br>\r\n <img width=\"70%\" height=\"70%\" src=\"https://raw.githubusercontent.com/PaPaPaulitos/sherlock-lib/master/images/sherlock-lib-logo.svg\">\r\n <br>\r\n <span>A fork of the <a href=\"https://github.com/sherlock-project/sherlock\">Sherlock Project</a></span>\r\n <br>\r\n <a href=\"https://github.com/sherlock-project/sherlock/blob/master/sites.md\">List of social networks</a>\r\n <br>\r\n</p>\r\n\r\nThis library was created to use the Sherlock Project in your own personal scripts.\r\n\r\n\r\n## Installation\r\n\r\n```console\r\n# installing using pip\r\n$ pip install sherlock-lib\r\n```\r\n\r\n## Usage\r\n\r\n```python\r\ndef search_target(username,timeout=60,sfw=False)\r\n```\r\n\r\n- **Username**: Target's name on social media\r\n- **Timeout**: Maximum search time on each site\r\n- **Safe for Work**: Remove NSFW(Not Safe for Work) sites\r\n\r\n> This function returns a dictionary with the name of the sites and the link to the target's profile on the sites.\r\n\r\n### Example\r\n\r\n```python\r\nfrom sherlock_lib import search_target\r\n\r\nusername = \"john_doe\"\r\n\r\nresult = search_target(username,sfw=True)\r\n\r\nfor k, v in result.items():\r\n print(f\"{k}: {v}\")\r\n\r\n```\r\n\r\n## Contributing\r\nWe would love to have you help us with the development of Sherlock. Each and every contribution is greatly valued!\r\n\r\nHere are some things we would appreciate your help on:\r\n- Addition of new site support \u00c2\u00b9\r\n- Bringing back site support of [sites that have been removed](removed_sites.md) in the past due to false positives\r\n\r\n[1] Please look at the Wiki entry on [adding new sites](https://github.com/sherlock-project/sherlock/wiki/Adding-Sites-To-Sherlock)\r\nto understand the issues.\r\n\r\n\r\n\r\n## License\r\n\r\n- MIT \u00c2\u00a9 Sherlock Project<br/>\r\n- Original Creator - [Siddharth Dushantha](https://github.com/sdushantha)\r\n- Lib Creator - [Paulo Ricardo Mesquita](https://github.com/PaPaPaulitos)\r\n",
"bugtrack_url": null,
"license": "MIT License",
"summary": "\ud83d\udd0e Hunt down social media accounts by username across social networks",
"version": "0.1.3",
"project_urls": null,
"split_keywords": [
"sherlock",
"stalking",
"sherlock lib",
"sherlock-lib",
"stalking lib",
"stalking-lib",
"stalking with sherlock"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "6b77f41d75ede84574e7b409591e8f9b0ea195eb4281188fdf4413a44e9f325c",
"md5": "711f848ebe9333c51e5304c936c3d052",
"sha256": "99d7a4acf1a479babb4361e1b862c0e89bae2fa954e2af9f34a0fe8e4318e933"
},
"downloads": -1,
"filename": "sherlock_lib-0.1.3.tar.gz",
"has_sig": false,
"md5_digest": "711f848ebe9333c51e5304c936c3d052",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 16365,
"upload_time": "2023-12-19T04:26:32",
"upload_time_iso_8601": "2023-12-19T04:26:32.916069Z",
"url": "https://files.pythonhosted.org/packages/6b/77/f41d75ede84574e7b409591e8f9b0ea195eb4281188fdf4413a44e9f325c/sherlock_lib-0.1.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-12-19 04:26:32",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "sherlock-lib"
}
JSON