JobSearch

Automate job searches using windows powershell script, job websites API 's, JSON configuration files, and scheduled tasks.

Command line example:

powershell -file "C:\location\powershell\script\JobSearch.ps1" "C:\location\json\config\weekly-example.json" "email-password"

Configuration Example:

{
	"uri": "http://service.dice.com/api/rest/jobsearch/v2/simple.xml?",
	"mail-config": {
		"from": "[email protected]",
		"to": "[email protected]",
		"smtp": "smtp.gmail.com",
		"port": "587",
		"username": "[email protected]"
	},
	"searches": 
	[
			{
			"title": "Weekly - Support - Remote",
			"keyword": "support",
			"age": "7",
			"sort": "3",
			"telecommute": "true"
		},
		{
			"title": "Weekly - Support - 85258",
			"country": "USA",
			"age": "7",
			"sort": "1",			
			"keyword": "support",
			"city": "85258",
			"include": [
				"desk",
				"tech",
				"analyst"
			],
			"exclude": [
				"senior",
				"sr",
				"manager",
				"lead",
				"engineer",
				"director",
				"programmer"
			]
		},
		{
			"title": "Weekly - Support - Portland",		
			"country": "USA",
			"state": "OR",
			"city": "Portland",
			"age": "7",
			"sort": "1",			
			"keyword": "support",
			"parttime": "true"
		}
	]
}

Example Explained:

URI

• This is dice.com 's API end point
• API is currently at version 2

Mail Configuration

• Basic settings required by Powershells "Send-MailMessage" cmdlet
• Example uses gmail. Gmail may require you to authorize app
• Link to Gmail's SMTP documentation [here] (https://support.google.com/a/answer/176600?hl=en)

Searches

• You must have at least one search in the configuration file
• The only required value in a search is the keyword value
• Default values consist of: (country=USA, age=21, sort=1, title=Automated Dice JobSearch)

Dice Search Parameters

• keyword - Mandatory field used to search entire job posting for specified word
• title - Used in the subject line of the email
• country - ISO 3166 Country Code [List] (https://www.iso.org/obp/ui/#search)
• state - US Postal State Code [List] (http://www.bls.gov/cew/cewedr10.htm)
• city - ZIP Code or City Name
• skill - Searches the skill section for specified word
• direct - Direct Hire (true or false)
• telecommute - Position is listed as telecommute (true or false)
• fulltime - This is a full time position (true or false)
• parttime - This is a part time position (true or false)
• contract - This is a contract position (true or false)

Special Search Parameters

• I have created two special parameters that allow you to fine tune the results by filtering out words in the job title.
• The search parameters are stored in the configuration file as an array, and can contain one or many items.
• The search parameters work as wildcards, so if you specify "desk", it will match "desktop", "deskjockey", etc.
• There is an include parameter, which only includes job titles that contain matches for the include parameters you specify.
• There is an exclude parameter, which excludes any job titles that contain matches for the exclude parameter you specify.
• Example: If you specify an include parameter of "Desk" and an exclude parameter of "Senior" it will match a job title of "Desktop Support", but it will not match a job title of "Senior Help Desk Manager".

Dice.com API reference:

http://www.dice.com/common/content/util/apidoc/jobsearch.html

Future Revisions

• remove default values from powershell script and put in config file
• switch dice api payload to JSON for consistency
• put html rgb values in configuration file to allow for custom colored tables
• add option to exclude jobs you have already applied for possibly by using job id number or some other means
• add some error checking
• add indeed job search
• de-dupe results produced from disparate job websites