Placed Resume Optimizer

AI-powered resume optimization for ATS compatibility, keyword matching, and bullet point quality — all via the Placed API. No MCP server required.

API Key

Load the key from ~/.config/placed/credentials, falling back to the environment:

if [ -z "$PLACED_API_KEY" ] && [ -f "$HOME/.config/placed/credentials" ]; then
  source "$HOME/.config/placed/credentials"
fi

If PLACED_API_KEY is still not set, ask the user:

"Please provide your Placed API key (get it at https://placed.exidian.tech/settings/api)"

Then save it for future sessions:

mkdir -p "$HOME/.config/placed"
echo "export PLACED_API_KEY=<key_provided_by_user>" > "$HOME/.config/placed/credentials"
export PLACED_API_KEY=<key_provided_by_user>

How to Call the API

placed_call() {
  local tool=$1
  local args=${2:-'{}'}
  curl -s -X POST https://placed.exidian.tech/api/mcp \
    -H "Authorization: Bearer $PLACED_API_KEY" \
    -H "Content-Type: application/json" \
    -d "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"$tool\",\"arguments\":$args}}" \
    | python3 -c "import sys,json; d=json.load(sys.stdin); print(d['result']['content'][0]['text'])"
}

Available Tools

Usage Examples

Check ATS compatibility:

placed_call "check_ats_compatibility" '{"resume_id":"res_abc123"}'
# Returns: ATS score, formatting recommendations

Get quality score:

placed_call "get_resume_quality_score" '{"resume_id":"res_abc123"}'
# Returns: overall score, breakdown by section

Analyze gaps vs. a job description:

placed_call "analyze_resume_gaps" '{
  "resume_id": "res_abc123",
  "job_description": "Senior Software Engineer at Stripe — Go, distributed systems, Kafka..."
}'
# Returns: critical gaps, keyword gaps, suggestions

Score resume-job match:

placed_call "match_job" '{
  "resume_id": "res_abc123",
  "job_description": "..."
}'
# Returns: match score 0-100, matched/missing keywords