# PhD-Seeker 🎓
[](https://pypi.org/project/phdseeker/)
[](https://github.com/Aghababaei/PhD-Seeker/archive/master.zip)
[](https://github.com/Aghababaei/PhD-Seeker/network/members)
[](https://github.com/Aghababaei/PhD-Seeker/blob/main/LICENSE)
[](https://github.com/Aghababaei/PhD-Seeker/stargazers)
[](https://github.com/Aghababaei/PhD-Seeker/issues)
[](https://pepy.tech/project/phdseeker)
[](https://pepy.tech/project/phdseeker)
PhD Seeker is a python web scraper to search for fully funded doctorate positions, advertised on well-known academic position websites.
If nowadays you are actively seeking a PhD position to pursue your studies, you must have realized that the process of searching for relevant vacancies is not straight forward. Visiting a large number of position advertising websites and encountering irrelevant commercials are two of the most common problems.
Simply modify the keywords and you will receive a CSV/XLSX file containing the last two pages from the most popular advertisers.
# Sources 📚
- [www.scholarshipdb.net](http://www.scholarshipdb.net "www.scholarshipdb.net")
- [www.findaphd.com](http://www.findaphd.com "www.findaphd.com")
# Next Goals 🎯
- [ ] Expanding the academic position advertising source
- [ ] Adding databases of different universities
- [ ] Finding and removing overlapped positions
- [ ] Adding LinkedIn search to get informed directly from university professors
- [X] Getting the keywords from command line instead of hard-coding the source
- [X] Fetching pages simultaneously
- [X] Checking the availability of the new updates of `phdseeker` and notifying the user
- [ ] GUI support
Installation
==============
## PyPi
**phdseeker** is available on [PyPi](http://pypi.python.org/pypi/phdseeker):
$ pip install phdseeker
## Git
You can get latest stable changes from github server:
$ git clone https://github.com/Aghababaei/PhD-Seeker.git
$ cd PhD-Seeker
$ python setup.py install
## Zip, Tarball
You can download the latest tarball.
### *nix
Get the latest tarball & install:
$ wget -O phdseeker-master.tar.gz https://github.com/Aghababaei/PhD-Seeker/archive/master.tar.gz
$ tar xvzf phdseeker-master.tar.gz && cd PhD-Seeker-main
$ python setup.py install
### Windows
#### Downloading Archive
Download latest zip archive.
https://github.com/Aghababaei/PhD-Seeker/archive/master.zip
Decompress it, and run the following command in root directory of `PhD-Seeker`
$ python setup.py install
#### Adding Python to Windows environmental variables
Prior to running codes, make sure that Python has been already added to environmental variables as a `PATH`, otherwise:
1. Right-click This PC and going to Properties.
2. Click on the Advanced system settings in the menu on the left.
3. Click on the Environment Variables button on the bottom right.
4. In the System variables section, select the Path variable and click on Edit. The next screen will show all the directories that are currently a part of the PATH variable.
5. Click on New and entering Python’s install directory.
#### Requirements
**phdseeker** is relied on several great python packages.
If you want to just run the code by calling the script, you need to install its dependencies, in advance.
```
pip install -r requirements.txt
```
# Usage
```
phdseeker
Usage:
phdseeker -h
phdseeker -V
phdseeker [-k <keywords> -c <countries> --maxpage=<n> --output=<filetype(s)> -v]
options:
-h --help Show this screen.
-V --version Output version information, and repositories' list and exit.
-v --verbose Show the found positions on the terminal.
-k <keywords>, --keywords=<keywords> Declare desired keywords to seek. [default: Computer Science, Machine Learning, Deep Learning]
-c <countries>, --countries=<countries> Filter by countries.
-o <filetype(s)>, --output=<filetype(s)> Set the output type csv/xlsx/both [default: both]
--maxpage=<n> Maximum number of pages to fetch. [default: 10]
```
### usage example
```
$ phdseeker -k 'Computer Science, Machine Learning' --maxpage=1 -v
Searching for the Keywords 'Computer Science, Machine Learning' in up to 1 page.
========================================::[ scholarshipdb ]::========================================
>> 704 positions found <<
===========================================::[ findaphd ]::==========================================
>> 72 positions found <<
>>>> 776 positions have been found in total.
Specifically, 21 records of them have been saved in the following files:
PhD_Positions_2022-08-08[Computer Science, Machine Learning].csv saved!
PhD_Positions_2022-08-08[Computer Science, Machine Learning].xlsx saved!
Elapsed time is 3.87
┏━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Country ┃ Date ┃ Title ┃
┡━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ 1 Belgium │ │ Application of machine learning to screen hyperspectral │
│ │ │ data for important soil and plant properties │
│ 2 China │ │ PhD student (m/f/d) in the field of engineering, │
│ │ │ computer science, technical software development, │
│ │ │ mathematics, physics, data engineering or similar │
│ 3 China │ │ SFI Centre for Research Training in Machine Learning │
│ 4 Cyprus │ │ SFI Centre for Research Training in Machine Learning │
│ 5 Denmark │ about 1 hour ago │ PhD Position in Computational Genetics and Machine │
│ │ │ Learning: analysis of multi-omics biological data in │
│ │ │ novel populations of Brachypodium │
│ 6 Denmark │ about 18 hours ago │ PhD Stipend in Human-in-the-loop Data Mining and Deep │
│ │ │ Learning on Graph Data (16-22068) │
│ 7 Germany │ │ Discovery of new materials for applications on glass │
│ │ │ using Deep Machine Learning and Data Analytics │
│ 8 Germany │ │ Novel techniques for neuromorphic reservoir computing │
│ 9 Netherlands │ 8 days ago │ PhD Candidate: Graph Neural Networks for Electricity and │
│ │ │ Gas Networks │
│ 10 Norway │ 3 months ago │ PhD Research Fellow in Informatics - Knowledge │
│ │ │ Representation and Machine Learning │
│ 11 Poland │ │ The Constitutive Law Establishment of Advanced High │
│ │ │ Strength Steel based on Machine Learning │
│ 12 Spain │ 14 days ago │ CALL 41-2022-1 Researcher in the Sustainable Artificial │
│ │ │ Intelligence (SAI) research unit │
│ 13 Suriname │ 8 days ago │ PhD "In silico prediction of antibiotic resistance" │
│ │ │ (M/F) │
│ 14 Sweden │ about 12 hours ago │ PhD student in Computational Science and Engineering │
│ │ │ with focus on Optimization for Federated Machine │
│ │ │ Learning │
│ 15 Switzerland │ about 2 months ago │ PhD position in the field of Machine Learning │
│ │ │ (Graph-based High-dimensional generative models) with │
│ │ │ application to Medical Data Analysis at the Department │
│ │ │ of Computer Science │
│ 16 United Kingdom │ about 20 hours ago │ Research Assistant │
│ 17 United Kingdom │ 3 days ago │ PhD Studentship: Implementation of Machine Learning at │
│ │ │ the Edge │
│ 18 United Kingdom │ │ Machine Learning Meets Sequential Monte Carlo Methods │
│ 19 United Kingdom │ │ PhD Studentship in Computer Science │
│ 20 United Kingdom │ │ SFI Centre for Research Training in Machine Learning │
│ 21 United Kingdom │ │ Scholarship for the PhD in Medical Sciences in the │
│ │ │ fields of Neuroscience and Biomedical Engineering for │
│ │ │ the PhD Research Project ‘Development of a closed-loop │
│ │ │ controller for automatic administration of anaesthetic │
│ │ │ and analgesic agents during surgery using machine │
│ │ │ learning methods’ │
└───────────────────┴────────────────────┴──────────────────────────────────────────────────────────┘
│ Out of 776 found Ph.D. positions, 21 have been fetched in 1 page │
└───────────────────────────────────────────────────────────────────────────────────────────────────┘
```
## Contributors
<a href="https://github.com/Aghababaei/PhD-Seeker/graphs/contributors">
<img src="https://contrib.rocks/image?repo=Aghababaei/PhD-Seeker" />
</a>
Raw data
{
"_id": null,
"home_page": "https://github.com/Aghababaei/PhD-Seeker",
"name": "phdseeker",
"maintainer": "Javad Razavian",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "javadr@gmail.com",
"keywords": "Ph.D. Positions,phdseeker,Academia",
"author": "Amin Aghababaei, Javad Razavian, Ana Paula Gomes",
"author_email": "amin.aghababaei@outlook.com, javadr@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/fe/74/d468726c3c0c018f34f650b526391464c5e47961f5cb7c2e50d0c165c4c7/phdseeker-0.4.7.tar.gz",
"platform": null,
"description": "# PhD-Seeker \ud83c\udf93\n\n[](https://pypi.org/project/phdseeker/)\n[](https://github.com/Aghababaei/PhD-Seeker/archive/master.zip)\n[](https://github.com/Aghababaei/PhD-Seeker/network/members)\n[](https://github.com/Aghababaei/PhD-Seeker/blob/main/LICENSE)\n[](https://github.com/Aghababaei/PhD-Seeker/stargazers)\n[](https://github.com/Aghababaei/PhD-Seeker/issues)\n[](https://pepy.tech/project/phdseeker)\n[](https://pepy.tech/project/phdseeker)\n\n\nPhD Seeker is a python web scraper to search for fully funded doctorate positions, advertised on well-known academic position websites.\n\nIf nowadays you are actively seeking a PhD position to pursue your studies, you must have realized that the process of searching for relevant vacancies is not straight forward. Visiting a large number of position advertising websites and encountering irrelevant commercials are two of the most common problems.\n\nSimply modify the keywords and you will receive a CSV/XLSX file containing the last two pages from the most popular advertisers.\n\n# Sources \ud83d\udcda\n- [www.scholarshipdb.net](http://www.scholarshipdb.net \"www.scholarshipdb.net\")\n- [www.findaphd.com](http://www.findaphd.com \"www.findaphd.com\")\n\n\n# Next Goals \ud83c\udfaf\n- [ ] Expanding the academic position advertising source\n- [ ] Adding databases of different universities\n- [ ] Finding and removing overlapped positions\n- [ ] Adding LinkedIn search to get informed directly from university professors\n- [X] Getting the keywords from command line instead of hard-coding the source\n- [X] Fetching pages simultaneously\n- [X] Checking the availability of the new updates of `phdseeker` and notifying the user\n- [ ] GUI support\n\nInstallation\n==============\n\n## PyPi\n\n**phdseeker** is available on [PyPi](http://pypi.python.org/pypi/phdseeker):\n\n $ pip install phdseeker\n\n## Git\n\nYou can get latest stable changes from github server:\n\n $ git clone https://github.com/Aghababaei/PhD-Seeker.git\n $ cd PhD-Seeker\n $ python setup.py install\n\n## Zip, Tarball\n\nYou can download the latest tarball.\n\n### *nix\n\nGet the latest tarball & install:\n\n $ wget -O phdseeker-master.tar.gz https://github.com/Aghababaei/PhD-Seeker/archive/master.tar.gz\n $ tar xvzf phdseeker-master.tar.gz && cd PhD-Seeker-main\n $ python setup.py install\n\n### Windows\n\n#### Downloading Archive\n\nDownload latest zip archive.\n\nhttps://github.com/Aghababaei/PhD-Seeker/archive/master.zip\n\nDecompress it, and run the following command in root directory of `PhD-Seeker`\n\n $ python setup.py install\n\n#### Adding Python to Windows environmental variables\n\nPrior to running codes, make sure that Python has been already added to environmental variables as a `PATH`, otherwise:\n\n1. Right-click This PC and going to Properties.\n2. Click on the Advanced system settings in the menu on the left.\n3. Click on the Environment Variables button o\u200bn the bottom right.\n4. In the System variables section, select the Path variable and click on Edit. The next screen will show all the directories that are currently a part of the PATH variable.\n5. Click on New and entering Python\u2019s install directory.\n\n\n#### Requirements\n**phdseeker** is relied on several great python packages.\nIf you want to just run the code by calling the script, you need to install its dependencies, in advance.\n```\npip install -r requirements.txt\n```\n\n# Usage\n```\nphdseeker\n\nUsage:\n phdseeker -h\n phdseeker -V\n phdseeker [-k <keywords> -c <countries> --maxpage=<n> --output=<filetype(s)> -v]\n\noptions:\n -h --help Show this screen.\n -V --version Output version information, and repositories' list and exit.\n -v --verbose Show the found positions on the terminal.\n -k <keywords>, --keywords=<keywords> Declare desired keywords to seek. [default: Computer Science, Machine Learning, Deep Learning]\n -c <countries>, --countries=<countries> Filter by countries.\n -o <filetype(s)>, --output=<filetype(s)> Set the output type csv/xlsx/both [default: both]\n --maxpage=<n> Maximum number of pages to fetch. [default: 10]\n```\n### usage example\n```\n$ phdseeker -k 'Computer Science, Machine Learning' --maxpage=1 -v\n\nSearching for the Keywords 'Computer Science, Machine Learning' in up to 1 page.\n========================================::[ scholarshipdb ]::========================================\n >> 704 positions found <<\n===========================================::[ findaphd ]::==========================================\n >> 72 positions found <<\n\n>>>> 776 positions have been found in total.\nSpecifically, 21 records of them have been saved in the following files:\nPhD_Positions_2022-08-08[Computer Science, Machine Learning].csv saved!\nPhD_Positions_2022-08-08[Computer Science, Machine Learning].xlsx saved!\nElapsed time is 3.87\n\u250f\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2533\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2533\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2513\n\u2503 Country \u2503 Date \u2503 Title \u2503\n\u2521\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2547\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2547\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2529\n\u2502 1 Belgium \u2502 \u2502 Application of machine learning to screen hyperspectral \u2502\n\u2502 \u2502 \u2502 data for important soil and plant properties \u2502\n\u2502 2 China \u2502 \u2502 PhD student (m/f/d) in the field of engineering, \u2502\n\u2502 \u2502 \u2502 computer science, technical software development, \u2502\n\u2502 \u2502 \u2502 mathematics, physics, data engineering or similar \u2502\n\u2502 3 China \u2502 \u2502 SFI Centre for Research Training in Machine Learning \u2502\n\u2502 4 Cyprus \u2502 \u2502 SFI Centre for Research Training in Machine Learning \u2502\n\u2502 5 Denmark \u2502 about 1 hour ago \u2502 PhD Position in Computational Genetics and Machine \u2502\n\u2502 \u2502 \u2502 Learning: analysis of multi-omics biological data in \u2502\n\u2502 \u2502 \u2502 novel populations of Brachypodium \u2502\n\u2502 6 Denmark \u2502 about 18 hours ago \u2502 PhD Stipend in Human-in-the-loop Data Mining and Deep \u2502\n\u2502 \u2502 \u2502 Learning on Graph Data (16-22068) \u2502\n\u2502 7 Germany \u2502 \u2502 Discovery of new materials for applications on glass \u2502\n\u2502 \u2502 \u2502 using Deep Machine Learning and Data Analytics \u2502\n\u2502 8 Germany \u2502 \u2502 Novel techniques for neuromorphic reservoir computing \u2502\n\u2502 9 Netherlands \u2502 8 days ago \u2502 PhD Candidate: Graph Neural Networks for Electricity and \u2502\n\u2502 \u2502 \u2502 Gas Networks \u2502\n\u2502 10 Norway \u2502 3 months ago \u2502 PhD Research Fellow in Informatics - Knowledge \u2502\n\u2502 \u2502 \u2502 Representation and Machine Learning \u2502\n\u2502 11 Poland \u2502 \u2502 The Constitutive Law Establishment of Advanced High \u2502\n\u2502 \u2502 \u2502 Strength Steel based on Machine Learning \u2502\n\u2502 12 Spain \u2502 14 days ago \u2502 CALL 41-2022-1 Researcher in the Sustainable Artificial \u2502\n\u2502 \u2502 \u2502 Intelligence (SAI) research unit \u2502\n\u2502 13 Suriname \u2502 8 days ago \u2502 PhD \"In silico prediction of antibiotic resistance\" \u2502\n\u2502 \u2502 \u2502 (M/F) \u2502\n\u2502 14 Sweden \u2502 about 12 hours ago \u2502 PhD student in Computational Science and Engineering \u2502\n\u2502 \u2502 \u2502 with focus on Optimization for Federated Machine \u2502\n\u2502 \u2502 \u2502 Learning \u2502\n\u2502 15 Switzerland \u2502 about 2 months ago \u2502 PhD position in the field of Machine Learning \u2502\n\u2502 \u2502 \u2502 (Graph-based High-dimensional generative models) with \u2502\n\u2502 \u2502 \u2502 application to Medical Data Analysis at the Department \u2502\n\u2502 \u2502 \u2502 of Computer Science \u2502\n\u2502 16 United Kingdom \u2502 about 20 hours ago \u2502 Research Assistant \u2502\n\u2502 17 United Kingdom \u2502 3 days ago \u2502 PhD Studentship: Implementation of Machine Learning at \u2502\n\u2502 \u2502 \u2502 the Edge \u2502\n\u2502 18 United Kingdom \u2502 \u2502 Machine Learning Meets Sequential Monte Carlo Methods \u2502\n\u2502 19 United Kingdom \u2502 \u2502 PhD Studentship in Computer Science \u2502\n\u2502 20 United Kingdom \u2502 \u2502 SFI Centre for Research Training in Machine Learning \u2502\n\u2502 21 United Kingdom \u2502 \u2502 Scholarship for the PhD in Medical Sciences in the \u2502\n\u2502 \u2502 \u2502 fields of Neuroscience and Biomedical Engineering for \u2502\n\u2502 \u2502 \u2502 the PhD Research Project \u2018Development of a closed-loop \u2502\n\u2502 \u2502 \u2502 controller for automatic administration of anaesthetic \u2502\n\u2502 \u2502 \u2502 and analgesic agents during surgery using machine \u2502\n\u2502 \u2502 \u2502 learning methods\u2019 \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n\u2502 Out of 776 found Ph.D. positions, 21 have been fetched in 1 page \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n```\n\n\n## Contributors\n\n<a href=\"https://github.com/Aghababaei/PhD-Seeker/graphs/contributors\">\n <img src=\"https://contrib.rocks/image?repo=Aghababaei/PhD-Seeker\" />\n</a>\n\n\n",
"bugtrack_url": null,
"license": "GPLv3",
"summary": "PhD Seeker is a python web scraper to search for fully funded doctorate positions, advertised on well-known academic position websites.",
"version": "0.4.7",
"split_keywords": [
"ph.d. positions",
"phdseeker",
"academia"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "fe74d468726c3c0c018f34f650b526391464c5e47961f5cb7c2e50d0c165c4c7",
"md5": "2ce8112c89e7f70d2aaa26678b66dd43",
"sha256": "50117bf05d9d4954b7eeeb09abed5c0e1706db2e48f499e967188584d3b3efeb"
},
"downloads": -1,
"filename": "phdseeker-0.4.7.tar.gz",
"has_sig": false,
"md5_digest": "2ce8112c89e7f70d2aaa26678b66dd43",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 25882,
"upload_time": "2023-01-25T20:44:56",
"upload_time_iso_8601": "2023-01-25T20:44:56.743585Z",
"url": "https://files.pythonhosted.org/packages/fe/74/d468726c3c0c018f34f650b526391464c5e47961f5cb7c2e50d0c165c4c7/phdseeker-0.4.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-01-25 20:44:56",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "Aghababaei",
"github_project": "PhD-Seeker",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "phdseeker"
}
JSON
